mirror of
https://github.com/9001/copyparty.git
synced 2025-10-18 06:22:18 -06:00
54 lines
2.3 KiB
Markdown
54 lines
2.3 KiB
Markdown
standalone programs which take an audio file as argument
|
|
|
|
**NOTE:** these all require `-e2ts` to be functional, meaning you need to do at least one of these: `apt install ffmpeg` or `pip3 install mutagen`
|
|
|
|
some of these rely on libraries which are not MIT-compatible
|
|
|
|
* [audio-bpm.py](./audio-bpm.py) detects the BPM of music using the BeatRoot Vamp Plugin; imports GPL2
|
|
* [audio-key.py](./audio-key.py) detects the melodic key of music using the Mixxx fork of keyfinder; imports GPL3
|
|
|
|
these invoke standalone programs which are GPL or similar, so is legally fine for most purposes:
|
|
|
|
* [media-hash.py](./media-hash.py) generates checksums for audio and video streams; uses FFmpeg (LGPL or GPL)
|
|
* [image-noexif.py](./image-noexif.py) removes exif tags from images; uses exiftool (GPLv1 or artistic-license)
|
|
|
|
these do not have any problematic dependencies at all:
|
|
|
|
* [cksum.py](./cksum.py) computes various checksums
|
|
* [exe.py](./exe.py) grabs metadata from .exe and .dll files (example for retrieving multiple tags with one parser)
|
|
* [wget.py](./wget.py) lets you download files by POSTing URLs to copyparty
|
|
|
|
|
|
# dependencies
|
|
|
|
run [`install-deps.sh`](install-deps.sh) to build/install most dependencies required by these programs (supports windows/linux/macos)
|
|
|
|
*alternatively* (or preferably) use packages from your distro instead, then you'll need at least these:
|
|
|
|
* from distro: `numpy vamp-plugin-sdk beatroot-vamp mixxx-keyfinder ffmpeg`
|
|
* from pypy: `keyfinder vamp`
|
|
|
|
|
|
# usage from copyparty
|
|
|
|
`copyparty -e2dsa -e2ts` followed by any combination of these:
|
|
* `-mtp key=f,audio-key.py`
|
|
* `-mtp .bpm=f,audio-bpm.py`
|
|
* `-mtp ahash,vhash=f,media-hash.py`
|
|
|
|
* `f,` makes the detected value replace any existing values
|
|
* the `.` in `.bpm` indicates numeric value
|
|
* assumes the python files are in the folder you're launching copyparty from, replace the filename with a relative/absolute path if that's not the case
|
|
* `mtp` modules will not run if a file has existing tags in the db, so clear out the tags with `-e2tsr` the first time you launch with new `mtp` options
|
|
|
|
|
|
## usage with volume-flags
|
|
|
|
instead of affecting all volumes, you can set the options for just one volume like so:
|
|
|
|
`copyparty -v /mnt/nas/music:/music:r:c,e2dsa:c,e2ts` immediately followed by any combination of these:
|
|
|
|
* `:c,mtp=key=f,audio-key.py`
|
|
* `:c,mtp=.bpm=f,audio-bpm.py`
|
|
* `:c,mtp=ahash,vhash=f,media-hash.py`
|