[FAQ] Hidden options within the config.ini

Information and Tutorials on features in Mylar and how to use it
Locked
User avatar
evilhero
Site Admin
Posts: 2002
Joined: Sat Apr 20, 2013 3:43 pm
Contact:

[FAQ] Hidden options within the config.ini

Post by evilhero » Tue Aug 11, 2015 10:04 pm

There are numerous options that are available within the config.ini, but are not present via the GUI. I've often referred to them as being 'hidden configuration options', so because they're hidden and not many/any people are aware of them, I thought it might be a good idea to at least present some information about the items (in case I croak from java overdose).

Note that this is probably not an exhaustive list, and only goes into detail about options not available within the GUI. I'll add to this if/when I add more items as 'hidden' options.

multiple_dest_dirs (MDD): Used to specify multiple destination directories instead of using just the main ComicLocation. When this has an entry, Mylar will assume that any NEW issues for a series will put in the default Comic Location, and the folder specified here will not have anything added to it (ie. Like an Archive directory where nothing happens to the files). *Note* that the series folder in the MDD specified location must be exactly the same as the complete ComicLocation path. So:
(would work)

Code: Select all

destination_dir = /mnt/Comics/Batman-2011 
multiple_dest_dirs = /mnt/Archive/Comics/Batman-2011
(would not work)

Code: Select all

destination_dir = /mnt/Comics/Batman-2011 
multiple_dest_dirs = /mnt/Archive/Comics/Batman 2011
alt_pull (0/1): If enabled, when mylar attempts to pull down the newest weekly-pull list will poll against the actual webpage vs the csv file (default). What this means, is that if the csv file location is incorrect on the site mylar pulls it from (which has happened once/twice over the past year or so), it will never get updated whereas the website is obviously updated correctly. As an added benefit, the web page is updated a few days earlier than the csv file so you can see the new releases abit earlier.

ignore_havetotal (0/1): If enabled, will add any issues in a series with a status of Ignored to the Total Have count for that series.

snatched_havetotal (0/1): If enabled, will add any issues in a series with a status of Snatched to the Total Have count for that series.

syno_fix (0/1): Some synology users were having some issues with the beautiful soup library being located in the wrong place (more specifically a module within the library) where it was loading the incorrect version. Enabling this option forces Mylar to use the one bundled with it.

grabbag_dir: When Mylar pulls down issues that are labelled as a 'one-off' on the weekly-pull list, since there is no corresponding series directory for it to move the files to when post-processing, it will put them in this location if specified. By default, if nothing is specified, it will be a folder called 'Grabbag' located off of the destination_dir location.

unrar_cmd: The full path on the local machine to the unrar binary without the actual executable included in the path.

update_ended (0/1): When doing an 'DB Update All Active Comics' from the manage tab (or if it's at the 48-hr interval where it runs automatically), Mylar will ONLY update series that are in a Continuing Status, and not update series in an Ended status. This may cause some problems with series that don't follow a normal publication run and/or have rebooted series/issues that are abit out of alignment.

biggie_pub: (default:55) For series that are published by Marvel, DC, Darkhorse which usually follow a typical publication schedule (ie. monthly). If a series hasn't had an issue published within 55 days (the default), it will be considered as 'Ended'. Setting this too high or low might cause some problems with series that have been rebooted in the same year and/or if you have same series on your watchlist.

indie_pub: (default:75) For series that are not published by Marvel, DC, Darkhorse which tend (on average) to not follow a typical publication schedule. If a series hasn't had an issue published within 75 days (the default), it will be considered as 'Ended'. Setting this too high or low might cause some problems with series that have been rebooted in the same year and/or if you have same series on your watchlist.

upcoming_snatched (0/1): If enabled, will show the Snatched Filter on the Upcoming tab where you can see all issues that are in Wanted/Snatched/Failed (if the Failed option is enabled within Mylar). By default it's not enabled, so it will show just Wanted/Failed as necessary.

provider_order: The search provider order that is desired by the user. This can be in any order and can mix-match torrents and nzb providers freely. This is generated at startup ONLY (which it is a requirement to restart/shutdown Mylar after ANY saved provider change is done in the configuration). The format of the order in sequential order: #, provider name, #, provider name, etc (ie. 0, kat, 1, experimental, 2, nzbhouze).
There have been noticeable instances when a configuration change has been done and Mylar was not restarted, the error message in the logs indicates that no providers have been selected and fails to search for anything. In these cases the only fix is to delete this entire line from the config.ini (with Mylar shutdown), save the config.ini and then start mylar.

snatchedtorrent_notify (0/1): Post-processing notification on issues that were snatched via torrents using Mylar. This can occur at any point after they were snatched as long as said torrents were snatched via Mylar.

altexperimental (0/1): Enabled by default. When enabled will send an additional request to the Experimental option


The FOLLOWING options should ONLY be used/enabled when required. Doing so when Mylar is running will cause serious problems.

The 3 following options are all required when changing the Comic Location path for an entire DB (watchlist)

locmove (0/1): Enabling this option will force Mylar to initiate a Comic Location path update for all series in your watchlist upon the next startup. This option is required for newcom_dir and ffnewcom_dir to work.

newcom_dir: The full path to the new Comic Location that is desired.

fftonewcom_dir (0/1): If enabled, will apply the Folder Format string to each and every series in your watchlist as it's re-generating the new Comic Location paths within Mylar. This will work for multi-levelled Format strings as well (ie. if you have $Publisher/$Series-($Year) as your Folder Format string). This DOES NOT create the folders - it merely changes the location within Mylar, which is necessary for post-processing, file-checking, etc.

Locked