https://github.com/terhechte/satokoda
Write Podcast ID3 tags into MP3 Files
https://github.com/terhechte/satokoda
Last synced: 3 months ago
JSON representation
Write Podcast ID3 tags into MP3 Files
- Host: GitHub
- URL: https://github.com/terhechte/satokoda
- Owner: terhechte
- Created: 2019-03-15T13:14:26.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-03-17T19:20:40.000Z (over 6 years ago)
- Last Synced: 2025-01-27T22:44:41.569Z (5 months ago)
- Language: Swift
- Size: 3.91 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Satokoda
Satokoda is a small tool to set `ID3` tags on MP3 files from a commandline interface.
It is limited to the necessary tags required for the [Contravariance](https://contravariance.rocks)
Podcast. However, feel free to create a pull request to extend the options.
## Usage
Satokoda has two different inputs for the MP3 tags.
- Static inputs: These are usually the same for each episode in a podcast (i.e. the podcast title). They are
defined in a [`.toml`](https://github.com/toml-lang/toml/blob/master/versions/en/toml-v0.5.0.md) TOML
file.
- Dynamic inputs: They change each episode. They're provided as command line flags to `Satokoda`.
Here is a example `toml` file with the currently known tags:
``` TOML
# The cover image for the mp3
image_path = "/tmp/my_podcast_image"
# The year of podcast production
year = 2019
# The album for the podcast
album = "The Name of my Podcast"
# The artist for the podcast
artist = "My Name"
```
Then, `Satokoda` can be called with command line parameters to provide the remaining
parameter (the current `title` of this episode):
``` bash
usage: satokoda [ ...] [---] [ ...]
options:
-h, --help
Show description of usage and options of this tools.
-f, --filepath
The mp3 file to update
-t, --title
The title of the episode
-c, --configpath
The yaml configuration path
```
Here is an example incantation of `Sakotoda`:
``` bash
satokoda -f ~/Desktop/episode_14.mp3 -t "14: What is your name" -c ./config.toml
```
`Satokoda` will write the `ID3` tags into your MP3 file.
License: MIT