Help & Documentation
How to use the DEFCON Translation Project
Getting Started
What is this project?
The DEFCON La Villa Translation Project aims to translate DEFCON conference content (videos, presentations, subtitles) into Spanish to make this knowledge accessible to the Spanish-speaking security community.
How do I get an API key?
Contact the project maintainers through GitHub or the DEFCON La Villa community to request access. Once approved, you'll receive an API key to authenticate your requests.
How do I search for files?
Use the File Search page to browse and filter files by:
- File Type: MP4 (videos), PDF (slides), SRT/TXT (subtitles)
- Conference: Filter by specific DEFCON year or event
- Search Term: Search by filename or keywords
Contributing Translations
How do I submit a translation?
- Find a file that needs translation (status: "Not Started" or "In Progress")
- Download the original subtitle file (.srt or .txt)
- Translate the content using your preferred subtitle editor
- Submit the translated file through the API or web interface
What format should translations be in?
We accept VTT (WebVTT) and SRT formats. Maintain the original timing cues and structure. Each translation should include:
- Target language code (e.g., "es" for Spanish)
- Properly formatted subtitles with timing
- Accurate translations that preserve technical terminology
Translation guidelines
- Keep technical terms in English when there's no common Spanish equivalent
- Maintain hacker/security community terminology
- Preserve the speaker's tone and style
- Include context notes for cultural references if needed
API Usage
Authentication
Include your API key in the request header:
X-Api-Key: your_api_key_here
Common Endpoints
GET /api/files/search
Search for files
GET /api/files/download?ids=1,2,3
Download file URLs
POST /api/translations
Submit a translation
GET /api/translations/my
List your translations
Batch Download Script
Download our batch downloader script to efficiently download multiple files at once.
Status Definitions
Need More Help?
Check out the GitHub repository for issues, discussions, and to contribute to the project.