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

Content Search: Use /api/summary/search?q=your+query to search inside video transcripts and document summaries using full-text search. Results are ranked by relevance.

Contributing Translations

How do I submit a translation?

  1. Find a file that needs translation (status: "Not Started" or "In Progress")
  2. Download the original subtitle file (.srt or .txt)
  3. Translate the content using your preferred subtitle editor
  4. 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/{type} List files by type (mp4, pdf, txt, srt)
GET /api/files/download?ids=1,2,3 Download file URLs
POST /api/translation/start Start a translation job
GET /api/translation/{vttFileId} Get translations for a file

Summary & Search Endpoints

GET /api/summary/search?q=query Full-text search across summaries and keywords
GET /api/summary/{fileId} Get summary for a specific file
POST /api/summary Create or update summary

Batch Download Script

Download our batch downloader script to efficiently download multiple files at once.

Status Definitions

Not Started No translation work has begun
In Progress Someone is actively working on translation
Completed Translation is finished and reviewed

Need More Help?

Check out the GitHub repository for issues, discussions, and to contribute to the project.