{"id":19364355,"url":"https://github.com/davidfstr/hbencode","last_synced_at":"2026-06-13T02:31:40.701Z","repository":{"id":5147286,"uuid":"6314547","full_name":"davidfstr/hbencode","owner":"davidfstr","description":"Encodes video files in bulk for playback on an iPhone or iPod Touch.","archived":false,"fork":false,"pushed_at":"2022-05-15T21:23:58.000Z","size":14,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-25T13:33:17.051Z","etag":null,"topics":["handbrake","video-encoding"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"h2oai/h2o-3","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidfstr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-10-20T22:40:38.000Z","updated_at":"2022-05-15T21:22:06.000Z","dependencies_parsed_at":"2022-09-11T19:01:34.594Z","dependency_job_id":null,"html_url":"https://github.com/davidfstr/hbencode","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/davidfstr/hbencode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidfstr%2Fhbencode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidfstr%2Fhbencode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidfstr%2Fhbencode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidfstr%2Fhbencode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidfstr","download_url":"https://codeload.github.com/davidfstr/hbencode/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidfstr%2Fhbencode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34270414,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["handbrake","video-encoding"],"created_at":"2024-11-10T07:37:11.317Z","updated_at":"2026-06-13T02:31:40.670Z","avatar_url":"https://github.com/davidfstr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hbencode 1.1\n\nEncodes video files in bulk for playback on an iPhone or iPod Touch \n(non-retina), optimizing for space.\n\nI have used this program for several years to encode anime, movies, \nand TV shows for my iPhone so that I can watch them while on the bus, \non the plane, or otherwise stuck waiting for long periods of time.\n\n\n## Requirements\n\n* Operating System:\n    * Mac OS X 10.5.8 (Leopard) or later\n    * Linux \u0026mdash; probably works, but untested\n    * Windows \u0026mdash; probably works, but untested\n* [Python] 2.5.1 or later\n    * Already included on Mac OS X.\n* [HandBrakeCLI] 0.9.5 or later\n    * Tested with:\n        * HandBrakeCLI svn3563 (2010100201) - Reference implementation\n        * HandBrakeCLI svn3567 (2010100301)\n\n[Python]: http://www.python.org\n[HandBrakeCLI]: http://handbrake.fr/downloads2.php\n\n\n## Installation\n\nCopy `hbencode.py` to somewhere in your system path.\n\n\n## Usage\n\nEncode a file using:\n\n```\nhbencode.py INPUT_FILE.avi\n```\n\nEncode all files in the current directory using:\n\n```\nhbencode.py *.avi\n```\n\nThis will automagically encode the video(s) for iPhone / iPod Touch and save it\nto your preferred output directory.\n\n\n## Configuration and Options\n\nWhen run for the first time:\n\n1. hbencode will try to locate the `HandBrakeCLI` program in your \n   current `PATH`.\n    * If it cannot be found, you will be prompted to input its location manually.\n2. hbencode will prompt you for a directory to save all output files.\n\n\n### Automatic Mode\n\nIf the `--auto` option is specified, all other configuration options are detected automatically.\n\nThe particular heuristic for how these options are computed may change in subsequent versions of hbencode without warning. At present the current heuristic is:\n\n* Use an output aspect ratio which is as close to the input aspect ratio as possible.\n* Use constant quality encoding.\n* Use the first Japanese audio track if there is one, or the first one otherwise.\n* Use the first Japanese subtitle track if there is one, or the first one otherwise.\n* If there is a subtitle track, burn it in to the video.\n\n### Aspect Ratio\n\nThe output width, height, and bitrate of the encoded video are determined by\nthe aspect ratio of the input file.\nBy default this is assumed to be `--w1` (16:9, widescreen).\nThis be be overridden with other options such as `--tv` (4:3, traditional TV).\n\nYou can get a complete list of supported aspect ratios with the `-r list`\noption. Then use that ratio with `-r RATIO_NAME`\n\nIn the future, hbencode will try to automatically guess the aspect ratio of the\ninput file by default.\n\n### Increasing Encode Quality\n\nBy default, encoding parameters optimize for constant (and small) file size.\nIf you prefer to optimize for constant quality, use the `-C` option.\n\nOr if you want to multiply the automatically determined bitrate to increase\nquality (for music videos and similar), you can use the `-q 1.5` option to\nmultiply the bitrate by 1.5x (or any value).\n\nFinally, you can use one of the higher quality aspect ratio variants.\nFor example, if you normally use `-r w1` (the default), you can also use\n`-r w1-hq`. See the \"Aspect Ratio\" section for more details.\n\n### Subtitles\n\nSubtitles in the input file are detected and included in the output file by\ndefault. If you want to select a subtitle track other than the first one,\nuse `-s SUBTITLE_TRACK_NUMBER`.\n\nSubtitles are normally converted to plain text and stored as a native subtitle\ntrack for the iPhone. SSA subtitles (common in anime) can alternatively be\n**burned in** to the video track using the `-B` option. Subtitle burn-in is the\nmost accurate way to display SSA subtitles, at the cost of not being able to\nturn them off during playback.\n\n### Other Options\n\nYou can use `-x \"OPTION_1 OPTION_2 ... OPTION_N\"` to specify custom options to\nthe underlying `HandBrakeCLI` program.\n\nYou can get a complete list of supported options by running hbencode with no\nparameters:\n\n```\nhbencode.py\n```\n\n\n## Support\n\nIf you run into problems or have questions, feel free to file a\n[bug] or [contact] me.\n\n[contact]: http://dafoster.net/about#contact\n[bug]: https://github.com/davidfstr/hbencode/issues\n\n\n## Changelog\n\nInformation about earlier releases can be found in the [CHANGELOG].\n\n[CHANGELOG]: https://github.com/davidfstr/hbencode/blob/master/CHANGELOG.md\n\n\n## License\n\nThis software is licensed under the [MIT License].\n\n[MIT License]: https://github.com/davidfstr/hbencode/blob/master/LICENSE.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidfstr%2Fhbencode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidfstr%2Fhbencode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidfstr%2Fhbencode/lists"}