https://github.com/norm/media-tools
A set of shell scripts for dealing with media, such as CD rips, DVD rips and downloaded video.
https://github.com/norm/media-tools
apple-tv itunes itunes-library media-library shell shell-scripts
Last synced: 7 months ago
JSON representation
A set of shell scripts for dealing with media, such as CD rips, DVD rips and downloaded video.
- Host: GitHub
- URL: https://github.com/norm/media-tools
- Owner: norm
- Created: 2016-11-13T11:30:27.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2022-06-29T05:47:28.000Z (over 3 years ago)
- Last Synced: 2025-01-19T10:32:46.523Z (9 months ago)
- Topics: apple-tv, itunes, itunes-library, media-library, shell, shell-scripts
- Language: Shell
- Homepage:
- Size: 429 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.markdown
Awesome Lists containing this project
README
media-tools
===========
A set of shell scripts for dealing with media, such as CD rips, DVD rips
and downloaded video.
Video is converted with quality settings suitable for playback on an Apple TV
or modern iPad.
Built and tested on macOS, might work on other Unix-like operating systems.
## Installation
A control script `media` and a collection of associated handler scripts all
prefixed `media-` will be installed. Much like git they can be invoked
directly or by `media do-thing` by preference.
1. clone the repo
2. `./script/bootstrap` to install dependencies
3. `./script/test` to run the tests — this step is optional, and will download
some video files from the internet (even then, some tests will not run
because they expect CD and DVD rips that you most likely won't have)
4. `make install`
## Configuration
Several aspects of how `media` works, including the directories used, can be
set as environment variables or in a configuration file. See `media help
show-config` for more.
## Usage
To see general usage at any time, run `media` without arguments. This will
list the available commands with a brief summary of each. More help on any
command can be found by running `media help `.
### Converting TV episodes
**...from video files**
First, create a directory in the correct format: `House - 1x01 - Everybody
Lies` (this can be created with the command `media make-episode-dir House 1 1`).
Add the video file to the directory, and optionally a poster image (`poster.jpg`
or `poster.png`).
Run `media add `. This will convert the video, and file it in your
TV directory, in a subdirectory structure like
`${tv_base}/House/Season 1/01 Everybody Lies.m4v`.
Unless `ignore_itunes` is set, it will then be added to iTunes as a referenced
file (it stays in the same place in the filesystem) rather than as a managed
file (iTunes moves it as it sees fit, based on the metadata).
Lastly, if `trash_dir` is set, the directory will be cleaned up and the
original video file moved to the `trash_dir`. Otherwise it will remain.
**...from DVD sources**
Given a DVD image (I use [RipIt](http://thelittleappfactory.com/ripit/) to rip
my DVDs) `media add-video` will create a template `metadata.conf` file. Edit
this file to add the episode information and run `media add-video` with the
image again.
Media never removes DVD images, even if `trash_dir` is set.
### Movies
The code for movies has not yet been written.
### CDs
Use `media rip-cd` to rip the audio from a CD. This creates a directory with
the audio and a `metadata.conf` file containing album and track information,
which is populated from [freedb.org](http://www.freedb.org).
After editing the metadata, adding a file `cover.jpg` for the cover image, and
possibly editing the WAV files (I occasionally remove excessive silence, or
split "hidden" tracks out into separate tracks), run `media add-cd ` to
convert the ripped audio to AAC.
If `auto_add_dir` is set, the converted audio will be moved into it (the
intention is that you set this to the location of the "Automatically Add to
iTunes" directory in its library).