copyparty/bin/mtag
2022-01-17 00:27:23 +00:00
..
res vbi: add onscreen qrcode 2021-12-28 20:57:11 +01:00
audio-bpm.py fix mojibake support in misc mtp plugins 2021-11-20 17:33:24 +01:00
audio-key-slicing.py audio-key: truncate at 5min + mojibake support 2021-06-22 22:21:39 +02:00
audio-key.py fix mojibake support in misc mtp plugins 2021-11-20 17:33:24 +01:00
cksum.py add mtp plugin cksum.py 2021-10-03 19:35:20 +02:00
exe.py add multitag example 2021-05-29 03:43:30 +02:00
file-ext.py general-purpose file parsing 2021-05-16 07:04:18 +02:00
image-noexif.py add mtp plugin for exif stripping 2021-11-20 17:45:56 +01:00
install-deps.sh deal with github api change + build vamp if necessary 2022-01-17 00:27:23 +00:00
media-hash.py fix mojibake support in misc mtp plugins 2021-11-20 17:33:24 +01:00
README.md legalese rephrasing 2021-11-20 17:58:37 +01:00
sleep.py better task recovery on restart 2021-03-21 05:57:24 +01:00
very-bad-idea.py meadup changes 2022-01-03 01:16:27 +01:00
wget.py support multiple volume flags in one group 2021-09-18 23:45:43 +02:00
yt-ipr.py support multiple volume flags in one group 2021-09-18 23:45:43 +02:00

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 detects the BPM of music using the BeatRoot Vamp Plugin; imports GPL2
  • 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 generates checksums for audio and video streams; uses FFmpeg (LGPL or GPL)
  • 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 computes various checksums
  • exe.py grabs metadata from .exe and .dll files (example for retrieving multiple tags with one parser)
  • wget.py lets you download files by POSTing URLs to copyparty

dependencies

run 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