{"id":16653621,"url":"https://github.com/norm/media-tools","last_synced_at":"2026-05-23T08:02:33.649Z","repository":{"id":41165438,"uuid":"73611584","full_name":"norm/media-tools","owner":"norm","description":"A set of shell scripts for dealing with media, such as CD rips, DVD rips and downloaded video.","archived":false,"fork":false,"pushed_at":"2022-06-29T05:47:28.000Z","size":439,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-12-26T20:10:56.205Z","etag":null,"topics":["apple-tv","itunes","itunes-library","media-library","shell","shell-scripts"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/norm.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-13T11:30:27.000Z","updated_at":"2025-09-11T16:02:14.000Z","dependencies_parsed_at":"2022-09-08T04:51:11.266Z","dependency_job_id":null,"html_url":"https://github.com/norm/media-tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/norm/media-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fmedia-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fmedia-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fmedia-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fmedia-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/norm","download_url":"https://codeload.github.com/norm/media-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fmedia-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33387656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["apple-tv","itunes","itunes-library","media-library","shell","shell-scripts"],"created_at":"2024-10-12T09:46:04.703Z","updated_at":"2026-05-23T08:02:33.620Z","avatar_url":"https://github.com/norm.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"media-tools\n===========\n\nA set of shell scripts for dealing with media, such as CD rips, DVD rips\nand downloaded video.\n\nVideo is converted with quality settings suitable for playback on an Apple TV\nor modern iPad.\n\nBuilt and tested on macOS, might work on other Unix-like operating systems.\n\n\n## Installation\n\nA control script `media` and a collection of associated handler scripts all\nprefixed `media-` will be installed. Much like git they can be invoked\ndirectly or by `media do-thing` by preference.\n\n 1. clone the repo\n 2. `./script/bootstrap` to install dependencies\n 3. `./script/test` to run the tests — this step is optional, and will download\n    some video files from the internet (even then, some tests will not run \n    because they expect CD and DVD rips that you most likely won't have)\n 4. `make install`\n\n\n## Configuration\n\nSeveral aspects of how `media` works, including the directories used, can be\nset as environment variables or in a configuration file. See `media help\nshow-config` for more.\n\n\n## Usage\n\nTo see general usage at any time, run `media` without arguments. This will\nlist the available commands with a brief summary of each. More help on any\ncommand can be found by running `media help \u003ccommand\u003e`.\n\n### Converting TV episodes\n\n**...from video files**\n\nFirst, create a directory in the correct format: `House - 1x01 - Everybody\nLies` (this can be created with the command `media make-episode-dir House 1 1`).\nAdd the video file to the directory, and optionally a poster image (`poster.jpg`\nor `poster.png`).\n\nRun `media add \u003cdirectory\u003e`. This will convert the video, and file it in your\nTV directory, in a subdirectory structure like\n`${tv_base}/House/Season 1/01 Everybody Lies.m4v`.\n\nUnless `ignore_itunes` is set, it will then be added to iTunes as a referenced\nfile (it stays in the same place in the filesystem) rather than as a managed\nfile (iTunes moves it as it sees fit, based on the metadata).\n\nLastly, if `trash_dir` is set, the directory will be cleaned up and the\noriginal video file moved to the `trash_dir`. Otherwise it will remain.\n\n**...from DVD sources**\n\nGiven a DVD image (I use [RipIt](http://thelittleappfactory.com/ripit/) to rip\nmy DVDs) `media add-video` will create a template `metadata.conf` file. Edit\nthis file to add the episode information and run `media add-video` with the\nimage again.\n\nMedia never removes DVD images, even if `trash_dir` is set.\n\n### Movies\n\nThe code for movies has not yet been written.\n\n### CDs\n\nUse `media rip-cd` to rip the audio from a CD. This creates a directory with\nthe audio and a `metadata.conf` file containing album and track information,\nwhich is populated from [freedb.org](http://www.freedb.org).\n\nAfter editing the metadata, adding a file `cover.jpg` for the cover image, and\npossibly editing the WAV files (I occasionally remove excessive silence, or\nsplit \"hidden\" tracks out into separate tracks), run `media add-cd \u003cdir\u003e` to\nconvert the ripped audio to AAC.\n\nIf `auto_add_dir` is set, the converted audio will be moved into it (the\nintention is that you set this to the location of the \"Automatically Add to\niTunes\" directory in its library).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorm%2Fmedia-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnorm%2Fmedia-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorm%2Fmedia-tools/lists"}