{"id":13631952,"url":"https://github.com/dsymbol/decipher","last_synced_at":"2025-05-15T19:03:30.441Z","repository":{"id":93725598,"uuid":"549729491","full_name":"dsymbol/decipher","owner":"dsymbol","description":"Effortlessly add AI-generated transcription subtitles to your videos","archived":false,"fork":false,"pushed_at":"2024-11-13T23:58:08.000Z","size":53,"stargazers_count":541,"open_issues_count":3,"forks_count":63,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-03-31T23:33:53.838Z","etag":null,"topics":["openai","transcription","translation","whisper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsymbol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-11T16:35:47.000Z","updated_at":"2025-03-31T13:23:58.000Z","dependencies_parsed_at":"2025-01-04T12:52:19.459Z","dependency_job_id":null,"html_url":"https://github.com/dsymbol/decipher","commit_stats":{"total_commits":50,"total_committers":2,"mean_commits":25.0,"dds":"0.020000000000000018","last_synced_commit":"104f81cdcbb66ea00ab720b48347753984496e60"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsymbol%2Fdecipher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsymbol%2Fdecipher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsymbol%2Fdecipher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsymbol%2Fdecipher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsymbol","download_url":"https://codeload.github.com/dsymbol/decipher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247755560,"owners_count":20990620,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openai","transcription","translation","whisper"],"created_at":"2024-08-01T22:02:46.091Z","updated_at":"2025-04-08T00:36:56.523Z","avatar_url":"https://github.com/dsymbol.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Decipher 📺️\u003c/h1\u003e\n\nAI-generated transcription subtitles are a way to automatically add subtitles to your videos by using artificial intelligence to transcribe the audio from the video. This eliminates the need for manual transcription and can make your videos more accessible to a wider audience. Decipher uses [whisper](#what-is-whisper) to transcribe the audio taken from the video and create subtitles\n\n#### What is whisper?\n[Whisper](https://github.com/openai/whisper) is an automatic State-of-the-Art speech recognition system from OpenAI that has been trained on 680,000 hours\nof multilingual and multitask supervised data collected from the web. This large and diverse dataset leads to improved\nrobustness to accents, background noise and technical language.\n\n## Getting Started\n\nThere are two different ways to begin using decipher, depending on your preferences:\n\n* [`Google Colab`](#google-colab)\n* [`Manual`](#manual)\n\n### Google Colab\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/dsymbol/decipher/blob/main/notebook.ipynb)\n\nNotes:\n- Requires a (free) Google account\n- Instructions are embedded in the Colab Notebook\n\nGoogle Colab is a cloud-based platform for machine learning and data science, for free without the need for a powerful GPU of your own. It offers the option to borrow a powerful GPU (Tesla K80, T4, P4, or P100) on their server for free for a maximum of 12 hours per session. For those who require even more powerful GPUs and longer runtimes, Colab Pro/Pro+ options are available.\n\n### Manual\n\n#### Dependencies\n\n- [`Python`](https://www.python.org/downloads/)\n- [`ffmpeg`](https://ffmpeg.org/)\n\n#### Installation\n\n```\npip install git+https://github.com/dsymbol/decipher\n```\n\nor\n\n```\ngit clone https://github.com/dsymbol/decipher\ncd decipher \u0026\u0026 pip install . \n```\n*Note: Do NOT use 'pip install decipher'. It installs a different package.*\n\n#### GUI (gradio) usage\n\n```bash\ndecipher gui\n# or\npython -m decipher gui\n```\n\n#### Command-line usage\n\nThe `transcribe` subcommand allows you to transcribe a video file into a SubRip Subtitle (SRT) file. \nIt also has the option to automatically add the generated subtitles to the video.\n\nThe `subtitle` subcommand allows you to add subtitles to a video using an already existing SRT file. \nThis subcommand does not perform transcription, but rather assumes that the SRT file has already been created. \nIt is typically used by people who want to validate the accuracy of a transcription generated by the transcribe subcommand.\n\nTo get started right away:\n\n```bash\ndecipher --help\n```\n\nYou can run decipher as a package if running it as a script doesn't work:\n\n```bash\npython -m decipher --help\n```\n\n#### Command-line examples:\n\nGenerate SRT subtitles for video:\n\n```bash\ndecipher transcribe -i video.mp4 --model small\n```\n\nBurn generated subtitles into video:\n\n```bash\ndecipher subtitle -i video.mp4 --subtitle_file video.srt --subtitle_action burn\n```\n\nGenerate and burn subtitles into video without validating transcription:\n\n```bash\ndecipher transcribe -i video.mp4 --model small --subtitle_action burn\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsymbol%2Fdecipher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsymbol%2Fdecipher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsymbol%2Fdecipher/lists"}