Media Downloader

Media Manager similar to Radarr and Sonarr written in go First version! Bugs included

Main goal of project: Support multiple configurations for Series/Movies in one. Also do some additional checks and reduce memory footprint. API Only currently - no Interface

Inspirations: Radarr/Sonarr and Flexget

Table of Contents

• Breaking Change
• Features
  • Supported
    • Feed Sources
    • External Meta Sources
    • Indexers
    • Downloaders
    • Notifications
    • Media Templates
    • General
  • Under Consideration
• Ram Usage
• Get started
• After first Start - Trakt Authorize
• Donate
• Examples
• History

Breaking Change

• Moved Databases to databases subfolder!
• Moved config.toml to config subfolder
• Moved logs to logs subfolder
• added first webinterface (admin only - crashes sometimes - not many data validity checks)
• Webinterface Login: User: admin - Password: admin

Features

• Get Feeds of wanted media (Movies: Imdb Public Lists, Series: Local Wanted file --series.toml--)
• Get Metadata from IMDB, TMDB, OMDB, Trakt, TheTVDB
• Local Imdb Cache
• Missing/Upgradeble monitoring of Episode/Movie
• Search Newznab/Tornab Indexers
• Download nzb to directory, to Nzbget and torrent/magnet to deluge (others might follow)
• Parse files/nzbs
• Structure releases and delete lower quality files/nzbs
• Send Notification after Download start and/or Download finish (currently csv or pushover)
• Scheduler interval based (every x Minutes, Hours, Days) and/or cron based
• Api to start jobs, list/add/edit/delete movies/series/episodes, other actions. For API Call examples look at the Powershell examples in the api example file and at the Swagger Documentation
• External Api Limiter to reduce the chance of getting blocked
• toml Config for inital config and reconfiguration since there is no webinterface currently

Supported

Feed Sources

• IMDB Public List (Movies)
• Trakt Public+Private List (Movies + Shows)
• Trakt Popular (Movies, Shows)
• Trakt Trending (Movies, Shows)
• Trakt Anticipated (Movies, Shows)
• local wanted file (Shows)

External Meta Sources

• IMDB (mostly Movies)
• TMDB (Movies)
• OMDB (Movies)
• TRAKT (Movies + Shows)
• TVDB (Shows)

Indexers

• Newznab
• Torznab

Downloaders

• Drone (File Download NZB,Torrent)
• Nzbget (Nzb)
• Sabnzb (Nzb)
• qBittorrent (Torrent/Magnet)
• rTorrent (Torrent/Magnet untested)
• Deluge (Torrent/Magnet)

Notifications

• Pushover
• CSV (Write custom csv row)

Media Templates

• Series - You can configure multiple series groups and each group can contain multiple feeds and folders
• Movies - You can configure multiple movie groups and each group can contain multiple feeds and folders

General

• Regex Filtering Releases (Custom Filters for required and rejected)
• Schedulers (different intervals for all the actions) Support Interval and Cron based
• Limiters (You can define how much you want to storm an API)
• Configure which Meta Sources to use
• Configure your Qualities and their priorities (use parse/quality api to test this) including wanted and Defaults
• Use FProbe or mediainfo to get Media Information (dimensions, runtime, audio language)
• Currently completly API and Scheduler controlled - basic webinterface which needs to be replace is included

Under Consideration

• Download State Tracking
• Downloading of images from Meta Sites (unlikely)
• Handle multi media releases (ex. -CD1 -CD2) (maybe even joining those) (at the bottom of the list)
• Maybe also add the ability to download non matched episodes (which could't be found on a meta source site - risky since you might get a lot unwanted stuff) (at the bottom of the list) - using the download API you can Download excluded releases
• Unpacking of Downloaded stuff? Currently I let the downloaders do that and don't care about it that much
• Other Media Type Support (i could think of music but don't want to include this currently)
• Switch to db only configuration if I include a full webinterface
• Other Feed Sources (currently i don't need more - start a discussion if you want one specific - also you can add stuff using the API)
• Other Indexer Sources (currently i don't need more - start a discussion if you want one specific)
• Other Downloaders (currently i don't need more - start a discussion if you want one specific - ex qBittorrent)
• Other Notifications (currently i don't need more - start a discussion if you want one specific)
• Always: Add Additional Logging (currently mostly debugging stuff)
• Always: API Changes

Ram Usage

Currently seen: Constanly in use - between 30MB-400MB-peek:1-1.5GB Swap Memory: Default ~300-600MB - on a file move action the swap memory will grow to at least the complete file size - so for a 8GB file expect also this much!

Get started

• Guide for Docker:

  • Download Repository - and create docker container for build/run using compose files/nzbs
  • setup your config and name it config.toml ! - this will initialize the config.db -> it will create an example if no config could be found
  • setup your series.toml if wanted
  • Start the build container to build the executable (use compose-build.yml to create the container)
  • Start the run container to run the executable (use compose-run.yml to create the container)

• Guide for Windows/Linux/Mac:

  • Download latest prebuild zip for your OS or the latest release
  • setup your config and name it config.toml -> it will create an example if no config could be found
  • setup your series.toml if wanted
  • Run the go_media_downloader executable

• it will first build the imdb cache and then start importing your feeds, get metadata and scan/match the data - depending on your media repository size it might take several hours

• after the initial scan is finished the API and the scheduler will be started

• the scheduler will then scan for new releases and new/missing data in your folders and refresh your feeds

• You have to configure the templates and Media Groups - also if you want to use trakt, tmdb or omdb you have to get API Keys from them and enter them in the config

Find the API Documentation after start at: http://{server}:{port}/swagger/index.html or with more features but maybe not as current: https://go-media-downloader.readme.io/

After first Start - Trakt Authorize

• (This part is optional and only needed if you want to get private trakt lists)
• Create a Application within Trakt: https://trakt.tv/oauth/applications
• Write down ClientID and Secret
• Put ClientID and Secret into the config.toml
• Start app
• Open : http://{server}:{port}/api/trakt/authorize?apikey={apikey} to get a url to open
• Open Url in Browser
• Open : http://{server}:{port}/api/trakt/token/{code}?apikey={apikey} to get the token and save it - the code is in the url from the step above
• Best Practice restart App - You need to do this only once every 3 month if the expiry is reached

Donate

Donate

Examples

• Look into Wiki
• config: Movies FR and EN as Groups with the same or different feeds - Folders have to be different for the group (don't mix for example english and French Movies) - Use Different Qualities for each group! in the qualities are the Downloader/Indexer Definitions thats why - also please let the downloader place them in different directories otherwise they might mix
• exceptions: if a movie/show is in multiple lists i try to exclude them from the others (can be done in the config) so that i have the movie/show only in the list with the highest quality - if a movie/show is in 2 lists with different qualities the release would be constantly redownloaded
• if you want more help start a discussion - the system is running stable for some time now

History

• V0.1: initial Release
• V0.1.1: Performance and Ram Usage Changes - rewrite a lot of functions

Bugs

• Currently it may happen that new series won't be searched - use /api/series/search/id/123 endpoint in that case once after that it will update
• currently movies/series in different languages need to be in diffent root folders - ex. /share/Movies_EN and ..Movies_FR
• If a movie or episode isn't imported after download you might need to disable the runtime check