{"id":20424971,"url":"https://github.com/chetanxpro/autosub","last_synced_at":"2025-04-12T18:54:26.036Z","repository":{"id":222316955,"uuid":"727076366","full_name":"ChetanXpro/autosub","owner":"ChetanXpro","description":"Automatically generate and overlay subtitles for any video.","archived":false,"fork":false,"pushed_at":"2024-05-13T05:50:04.000Z","size":25593,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-18T03:45:28.642Z","etag":null,"topics":["ai","ffmpeg","nodejs-whisper","openai-whisper","subtitles","subtitles-generator","whisper"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/autosub","language":"TypeScript","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/ChetanXpro.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":"2023-12-04T06:09:36.000Z","updated_at":"2024-06-03T06:45:20.747Z","dependencies_parsed_at":null,"dependency_job_id":"72299bdf-df16-4bfd-9145-a120d8f69da1","html_url":"https://github.com/ChetanXpro/autosub","commit_stats":null,"previous_names":["chetanxpro/autosub"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChetanXpro%2Fautosub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChetanXpro%2Fautosub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChetanXpro%2Fautosub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChetanXpro%2Fautosub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChetanXpro","download_url":"https://codeload.github.com/ChetanXpro/autosub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618262,"owners_count":21134200,"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":["ai","ffmpeg","nodejs-whisper","openai-whisper","subtitles","subtitles-generator","whisper"],"created_at":"2024-11-15T07:11:42.464Z","updated_at":"2025-04-12T18:54:26.016Z","avatar_url":"https://github.com/ChetanXpro.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# autosub\n\nautosub uses ffmpeg and [OpenAI Whisper's nodejs bindings](https://github.com/ChetanXpro/nodejs-whisper) to automatically generate and overlay subtitles on any video.\n\n## Installation\n\nBefore using autosub, you need to have ffmpeg installed. You can install ffmpeg using your package manager:\n\n```bash\n# On Ubuntu or Debian\nsudo apt update \u0026\u0026 sudo apt install ffmpeg\n\n# On macOS using Homebrew (https://brew.sh/)\nbrew install ffmpeg\n\n# On Windows using Chocolatey (https://chocolatey.org/)\nchoco install ffmpeg\n```\n\nInstall Package\n- Note: When you run this project for the first time, it will automatically download an AI model and then compile it. If you encounter any errors during this process,\nplease raise an issue in the [Nodejs-Whisper](https://github.com/ChetanXpro/nodejs-whisper) repository.\n\n```bash\nnpm install -g autosub\n```\n\n## Usage\n\nGenerate subtitles for a video:\n\n```bash\nautosub generate -i \u003cAbsolute path to video\u003e -o \u003coutput path\u003e\n```\n\nOptions:\n\n- `-i, --input`: Absolute path to the input video file.\n- `-o, --output`: (Optional) Output path for the subtitled video. If not provided, the output will be saved in the same directory as the input file.\n\nExample:\n\n```bash\nautosub generate -i User/chetan/Developer/video.mp4 -o  User/chetan/Developer/output.mp4\n```\n\n## Development\n\nAvailable AI models to generate subtitles for video (bigger model will give better result)\n- For me tiny.en model works fine.\n- To changes AI model you need to change \"modelName\" value in transcription.ts\n\n| Model    | Disk    | Mem        |\n|----------|---------|------------|\n| tiny     | 75 MB   | ~390 MB    |\n| tiny.en  | 75 MB   | ~390 MB    |\n| base     | 142 MB  | ~500 MB    | \n| base.en  | 142 MB  | ~500 MB    | \n| small    | 466 MB  | ~1.0 GB    |\n| small.en | 466 MB  | ~1.0 GB    |\n| medium   | 1.5 GB  | ~2.6 GB    |\n| medium.en| 1.5 GB  | ~2.6 GB    |\n| large-v1 | 2.9 GB  | ~4.7 GB    | \n| large-v2 | 2.9 GB  | ~4.7 GB    |\n| large    | 2.9 GB  | ~4.7 GB    | \n\n\n\n\n\n\n## Todo List\n\n- [ ]  Command line interface support.\n- [ ]  Give options to change subtitle styles\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchetanxpro%2Fautosub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchetanxpro%2Fautosub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchetanxpro%2Fautosub/lists"}