Introduction

Documentaries shed light on the people and processes behind the technologies we take for granted. Open-source software, in particular, powers much of the internet, yet the communities and creators behind it often remain in the shadows. Whether you're inspired by shows like Cult.Repo or simply want to tell the story of a vital open-source project, this guide will walk you through making a compelling documentary. From pre-production to promotion, you'll learn how to capture the spirit of open source and highlight its impact on our digital world.

What You Need

• Camera – DSLR, mirrorless, or even a high-quality smartphone (1080p or 4K).
• Audio recorder – Lavalier microphone or portable recorder for clear interviews.
• Editing software – DaVinci Resolve, Adobe Premiere, or free tools like Shotcut.
• Computer – Capable of handling video editing (16GB+ RAM recommended).
• Storage – External hard drives or cloud storage for raw footage.
• Access to subjects – Permissions and contact with open-source developers, maintainers, or community members.
• Research materials – Project repositories, documentation, historical records.
• Release platform – YouTube, Vimeo, or a self-hosted streaming site (consider Creative Commons licensing).

Step-by-Step Guide

Step 1: Define Your Subject and Angle

Start by identifying an open-source project or key figure that fascinates you. It could be a major infrastructure component like a database or a small but innovative tool. Think about the story you want to tell: Is it the journey of a single developer? The impact of a project on global communication? Or the drama of a community split? Your angle will guide every decision.

Example: In Cult.Repo, producers Emma Tracey and Josiah McGarvie focused on the people behind technologies that uphold the internet. Choose a similar lens – human stories that illustrate the importance of open source.

Step 2: Research and Pre-Production

Dive deep into the project’s history, codebase, and community. Understand the technical context so you can ask informed questions. Create a timeline of key milestones, major contributors, and controversies. Reach out to potential interviewees early – developers may be busy, so be respectful of their time. Draft a treatment that outlines the narrative arc, themes, and visual style. This step is crucial for documentaries about open source because the technology itself can be abstract – you need to translate it into visual storytelling.

Step 3: Assemble Your Production Team

Documentaries are a collaborative effort. At minimum, you need a director/producer, a cinematographer, and an audio person. But you can also work solo with good planning. Look for team members who understand or are willing to learn about open source. Emma Tracey and Josiah McGarvie worked as producers – each person should have clear roles. If you lack budget, consider partnering with open-source communities; they often provide access to events or contributors.

Step 4: Conduct Interviews and Capture B-Roll

Interviews are the heart of your documentary. Prepare open-ended questions: “Why did you start this project?”, “What challenges did you face?”, “How does it feel to know your code runs half the web?” Record in a quiet environment, using good lighting to show the subject’s workspace – home office, coffee shop, or a hackathon. Capture plenty of B-roll: code scrolling on screens, developers typing, community meetups, server racks, and network diagrams. This visual material makes abstract concepts tangible.

Step 5: Structure the Narrative

In editing, organize your footage to create a beginning, middle, and end. Start with a hook – maybe a quote about the internet being fragile. Then introduce the project and the people behind it. Build tension by showing the problems the software solves or the community’s struggles. Climax with a major release or a moment of recognition. Conclude with the project’s legacy and ongoing importance. Use narration sparingly – let the interviewees and visuals tell the story.

Step 6: Incorporate Open-Source Aesthetics

Reflect the culture of open source in your editing. Use open-source color palettes (e.g., terminal green on black). Include screen recordings of actual code contributions, commits, or pull requests. Add subtle animations of network requests or data flow. The soundtrack could be royalty-free music from platforms like Free Music Archive or even community-composed tunes. This authenticity will resonate with viewers familiar with open source.

Step 7: Review and Fact-Check

Before finalizing, share a rough cut with a few trusted community members to verify technical accuracy. Open-source advocates value precision – a wrong term can damage credibility. Double-check dates, names, and project details. If you use code snippets, ensure they are correctly attributed. Emma Tracey and Josiah McGarvie likely did this step to ensure their documentary respected the subject matter. Get signed releases from all participants.

Step 8: Publish and Promote with Open-Source License

Choose a platform that aligns with open-source values. Upload to YouTube under a Creative Commons Attribution license, or host on PeerTube for a decentralized option. Write a short description with links to the project. Share the documentary on developer forums, mailing lists, and social media platforms like Reddit’s r/opensource. Consider embedding the video on the project’s official site. Encourage remixing and translation – this is the open source way.

Tips for Success

• Collaborate with the community – Invite subject matter experts as advisors or guest editors.
• Respect community norms – Open-source culture values transparency and inclusivity. Be honest about your intentions.
• Stay objective – Avoid taking sides in internal disputes. Present multiple viewpoints.
• Keep the human element central – Technology changes, but stories about passion and collaboration remain timeless.
• Plan for sustainability – Documentaries take time to produce, so secure funding or use cost-effective tools like open-source software for editing.
• Test your audio – Bad sound distracts more than shaky footage. Invest in a good microphone.
• Attend open-source conferences – Events like FOSDEM or OSCON are gold mines for interviews and community recording.
• Update your documentary – Open-source projects evolve. Consider releasing a follow-up or adding subtitles for accessibility.

By following these steps, you'll create a documentary that not only educates but also inspires viewers to appreciate and participate in open source. Lights, camera, action – and don't forget to commit your project to version control!