apollobetter is a script which automatically transcodes and uploads these files to apollo.rip.
The following command will scan through every FLAC you have ever downloaded or uploaded (if it is in , determine which formats are needed, transcode the FLAC to each needed format, and upload each format to Apollo -- automatically.
$ apollobetter
You're going to need to install a few dependencies before using apollobetter.
First and foremost, you will need Python 2.7 or newer. Will not run on Python 3 as requests is only available for Python 2.x.
Once you've got Python installed, you will need a few modules: mechanize, mutagen, and requests. Try this:
$ pip install -r requirements.txt
If you are on a seedbox, or a system without root priviliages, try this:
$ pip install --user -r requirements.txt
Furthermore, you need several external programs: mktorrent 1.1+, flac, lame, and sox. The method of installing these programs varies depending on your operating system, but if you're using something like Ubuntu you can do this:
# aptitude install mktorrent flac lame sox
If you are on a seedbox and you lack the privilages to install packages, you could contact your provider to have these packages installed.
At this point you may execute the following command:
$ apollobetter
And you will receive a notification stating that you should edit the configuration file ~/.apollobetter/config (if you're lucky).
You've made it far! Congratulations. Open up the file ~/.apollobetter/config in a text editor. You're going to see something like this:
[whatcd]
username =
password =
data_dir =
output_dir =
torrent_dir =
formats = flac, v0, 320, v2
media = sacd, soundboard, web, dvd, cd, dat, vinyl, blu-ray
24bit_behaviour = 0
tracker = https://mars.apollo.rip/
api = https://apollo.rip
mode = both
username
and password
are your apollo.rip login credentials.
data_dir
is the directory where your downloads are stored.
output_dir
is the directory where your transcodes will be created. If
the value is blank, data_dir
will be used. You can also specify
per format values such as output_dir_320
or output_dir_v0
.
torrent_dir
is the directory where torrents should be created (e.g.,
your watch directory). Same per format settings as output_dir apply.
formats
is a list of formats that you'd like to support
(so if you don't want to upload V2, just remove it from this list).
media
is a list of lossless media types you want to consider for
transcoding. The default value is all What.CD lossless formats, but if
you want to transcode only CD and vinyl media, for example, you would
set this to 'cd, vinyl'.
24bit_behaviour
defines what happens when the program encounters a FLAC
that it thinks is 24bits. If it is set to '2', every FLAC that has a bits-
per-sample property of 24 will be silently re-categorized. If it set to '1',
a prompt will appear. The default is '0' which ignores these occurrences.
tracker
is the base url to use in the torrent files.
api
is the base url to use for api requests.
mode
is which list of torrents to search for candidates. One of:
snatched
- Your snatched torrents.uploaded
- Your uploaded torrents.both
- Your uploaded and snatched torrents.seeding
- Better.php for your seeding torrents.all
- All transcode sources above.none
- Disable scraping.
You should end up with something like this:
[whatcd]
username = RequestBunny
password = clapton
data_dir = /srv/downloads
output_dir =
torrent_dir = /srv/torrents
formats = flac, v0, 320
media = cd, vinyl, web
24bit_behaviour = 0
tracker = https://mars.apollo.rip/
api = https://apollo.rip
mode = both
Alright! Now you're ready to use apollobetter.
usage: apollobetter [-h] [-s] [-j THREADS] [--config CONFIG] [--cache CACHE]
[-U] [-E] [--version] [-m MODE] [-S]
[release_urls [release_urls ...]]
positional arguments:
release_urls the URL where the release is located (default: None)
optional arguments:
-h, --help show this help message and exit
-s, --single only add one format per release (useful for getting
unique groups) (default: False)
-j THREADS, --threads THREADS
number of threads to use when transcoding (default: 7)
--config CONFIG the location of the configuration file (default:
~/.apollobetter/config)
--cache CACHE the location of the cache (default:
~/.apollobetter/cache)
-U, --no-upload don't upload new torrents (in case you want to do it
manually) (default: False)
-E, --no-24bit-edit don't try to edit 24-bit torrents mistakenly labeled
as 16-bit (default: False)
--version show program's version number and exit
-m MODE, --mode MODE mode to search for transcode candidates; snatched,
uploaded, both, seeding, or all (default: None)
-S, --skip treats a torrent as already processed (default: False)
If you're running it on RED, turn mode to none to avoid getting banned.
To transcode and upload every snatch you've ever downloaded along with all your uploads (this may take a while):
$ apollobetter
To transcode and upload a specific release (provided you have already
downloaded the FLAC and it is located in your data_dir
):
$ apollobetter http://apollo.rip/torrents.php?id=1000\&torrentid=1000000
Note that if you specify a particular release(s), apollobetter will ignore your configuration's media types and attempt to transcode the releases you have specified regardless of their media type (so long as they are lossless types).
Your first time running apollobetter might take a while, but after it has successfully gone through and checked everything, it'll go faster any consecutive runs due to its caching method