mirror of
https://github.com/evilhero/mylar
synced 2024-12-23 00:02:38 +00:00
Updated README
labeled sections with proper headers added link to API key clarified code input in "Usage" section cleaned up "Usage" section cleaned up "Renaming" section created a section for "Screenshots"
This commit is contained in:
parent
bf1e479b2a
commit
b8bb7f14fc
1 changed files with 33 additions and 27 deletions
60
README.md
60
README.md
|
@ -1,52 +1,58 @@
|
||||||
Mylar is an automated Comic Book (cbr/cbz) downloader program heavily-based on the Headphones template and logic (which is also based on Sick-Beard).
|
Mylar is an automated Comic Book (cbr/cbz) downloader program heavily-based on the Headphones template and logic (which is also based on Sick-Beard).
|
||||||
|
|
||||||
Yes, it does work, yes there are still bugs, and for that reason I still consider it the definition of an 'Alpha Release'.
|
This program is considered an "Alpha release". It is not bug-free, but it does work!
|
||||||
|
|
||||||
-REQUIREMENTS-
|
## Requirements
|
||||||
- At least version 2.7.9 Python for proper usage (3.x is not supported).
|
- At least Python version 2.7.9 (3.x is not supported)
|
||||||
|
- ComicVine API key (found [here](https://comicvine.gamespot.com/api/) - program will have limited to no functionality without it
|
||||||
|
|
||||||
** NEW **
|
## Usage
|
||||||
You will need to get your OWN ComicVine API Key for this application to fully work.
|
To start the program, type `python Mylar.py` inside the root of the Mylar directory. Typing `python Mykar.py --help` will give a list of available options.
|
||||||
Failure to do this will result in limited (to No) ability when using Mylar.
|
|
||||||
|
|
||||||
To start it, type in 'python Mylar.py' from within the root of the mylar directory. Adding a --help option to the command will give a list of available options.
|
|
||||||
|
|
||||||
Once it's started, navigate to localhost:8090 in your web browser (or whatever IP the machine that has Mylar is on).
|
Once it's started, navigate to localhost:8090 in your web browser (or whatever IP the machine that has Mylar is on).
|
||||||
|
|
||||||
Here are some helpful hints hopefully:
|
Helpful hints:
|
||||||
- Add a comic (series) using the Search button, or using the Pullist.
|
- Add a comic (series) using the Search button or the Pullist
|
||||||
- Make sure you specify Comic Location in the Configuration!
|
- Ensure Comic Location is specified in settings
|
||||||
(Mylar auto-creates the Comic Series directories under the Comic Location. The directory is displayed on the Comic Detail page).
|
- Mylar auto-creates the Comic Series directories under the Comic Location. The directory is displayed on the Comic Detail page).
|
||||||
- If you make any Configuration changes, shutdown Mylar and restart it or else errors will occur - this is an outstanding bug.
|
- Restart Mylar after any settings changes, or else errors will occur
|
||||||
- You need to specify a search-provider in order to perform any search-related function!
|
- A search provider needs to be specified to perform any search-related functions
|
||||||
- In the Configuration section, if you enable 'Automatically Mark Upcoming Issues as Wanted' it will mark any NEW comic from the Pullist that is on your 'watchlist' as wanted.
|
- Enabling 'Automatically Mark Upcoming Issues as Wanted' in settings will mark any **NEW** comic from the Pullist that is on your 'watchlist' as wanted
|
||||||
- There are times when adding a comic it will fail with an 'Error', submit a bug and it will be checked out (usually an easy fix).
|
- If adding a comic fails with "Error", submit a bug and it will be checked out (usually an easy fix)
|
||||||
- For the most up-to-date build, use the Development build. Master doesn't get updated as frequently (> month), and Development is usually fairly stable.
|
- For the most up-to-date build, use the Development build
|
||||||
|
- Master doesn't get updated as frequently (> month), and Development is usually stable
|
||||||
|
|
||||||
The Mylar Forums are also online @ http://forum.mylarcomics.com
|
The Mylar Forums are also online @ http://forum.mylarcomics.com
|
||||||
|
|
||||||
Please submit issues via git for any outstanding problems that need attention.
|
Please submit issues via Git for any outstanding problems that need attention.
|
||||||
|
|
||||||
Post-Processing
|
## Post-processing
|
||||||
(Post-Processing is similar to the way SickBeard handles it.)
|
(Post-Processing is similar to the way SickBeard handles it.)
|
||||||
|
|
||||||
- Within the post-processing/ folder of Mylar there are 2 files (autoProcessComics.py and autoProcessComics.cfg.sample)
|
- Within the post-processing/ folder of Mylar there are 2 files (autoProcessComics.py and autoProcessComics.cfg.sample)
|
||||||
- Within the post-processing/ folder of Mylar there are 2 directories (nzbget, sabnzbd) and within each of these client folders, is a ComicRN.py script that is to be used with the respective download client.
|
- Within the post-processing/ folder of Mylar there are 2 directories (nzbget, sabnzbd) and within each of these client folders is a ComicRN.py script that is to be used with the respective download client.
|
||||||
- Edit (put in your Mylar host, port, login and password (if required), and ssl(0 for no, 1 for yes) and rename the autoProcessComics.cfg.sample to autoProcessComics.cfg.
|
- Edit (put in your Mylar host, port, login and password (if required), and ssl(0 for no, 1 for yes) and rename the autoProcessComics.cfg.sample to autoProcessComics.cfg.
|
||||||
- Copy autoProcessComics.py, autoProcessComics.cfg and the respective ComicRN.py into your SABnzbd/NZBGet scripts directory (or wherever your download client stores its scripts).
|
- Copy autoProcessComics.py, autoProcessComics.cfg and the respective ComicRN.py into your SABnzbd/NZBGet scripts directory (or wherever your download client stores its scripts).
|
||||||
- Make sure SABnzbd/NZBGet is setup to have a 'comic-related' category that points it to the ComicRN.py script that was just moved.
|
- Make sure SABnzbd/NZBGet is setup to have a 'comic-related' category that points it to the ComicRN.py script that was just moved.
|
||||||
- Ensure in Mylar that the category is named exactly the same.
|
- Ensure in Mylar that the category is named exactly the same.
|
||||||
|
|
||||||
Renaming
|
## Renaming files and folders
|
||||||
- You can now specify Folder / File Formats.
|
You can now specify how Mylar creates the names of files and folders.
|
||||||
- Folder Format - if left blank, it will default to just using the default Comic Directory [ and creating subdirectories beneath in the format of ComicName-(Year) ]
|
|
||||||
You can do multi-levels as well - so you could do $Publisher/$Series/$Year to have it setup like DC Comics/Batman/2011 (as an example)
|
|
||||||
- File Format - if left blank, Mylar will use the original file and not rename at all. This includes replacing spaces, and zero suppression (both renaming features).
|
|
||||||
- Folder Format IS used on every Add Series / Refresh Series request. Enabling Renaming has no bearing on this, so make sure if you're not using the default, that it's what you want.
|
|
||||||
|
|
||||||
|
### Folder Format
|
||||||
|
- If left blank, it will default to just using the default Comic Directory
|
||||||
|
- Will create subdirectories in the format `ComicName-(Year)`
|
||||||
|
- You can do multi-levels as well - so you could do $Publisher/$Series/$Year to have it setup like DC Comics/Batman/2011 (as an example)
|
||||||
|
- Folder Format **is** used on every Add Series / Refresh Series request
|
||||||
|
- Enabling `Renaming` has no bearing on this, so make sure if you're not using the default, that it's what you want.
|
||||||
|
|
||||||
Please help make it better, by sending in your bug reports / enhancement requests or just say what's working for you.
|
### File Format
|
||||||
|
- If left blank, Mylar will use the original file and not rename at all
|
||||||
|
- This includes replacing spaces, and zero suppression (both renaming features)
|
||||||
|
|
||||||
|
You can contribute by sending in your bug reports / enhancement requests. Telling us what's working for you helps too!
|
||||||
|
|
||||||
|
## Screenshots
|
||||||
The Main page ...
|
The Main page ...
|
||||||
![preview thumb](http://i.imgur.com/GLGMj.png)
|
![preview thumb](http://i.imgur.com/GLGMj.png)
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue