Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ilarramendi/BetterCovers
BetterCovers is a fully customizable script to automaticaly generate covers and backdrops with embeded ratings, mediainfo, language, certifications, age ratings, source, production companies, etc!
https://github.com/ilarramendi/BetterCovers
backdrop cover emby imdb jellyfin letterboxd metacritic omdb poster tmdb tvtime
Last synced: about 2 months ago
JSON representation
BetterCovers is a fully customizable script to automaticaly generate covers and backdrops with embeded ratings, mediainfo, language, certifications, age ratings, source, production companies, etc!
- Host: GitHub
- URL: https://github.com/ilarramendi/BetterCovers
- Owner: ilarramendi
- License: gpl-3.0
- Created: 2021-10-24T05:50:20.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-06-02T19:06:18.000Z (over 2 years ago)
- Last Synced: 2024-06-12T11:27:11.070Z (3 months ago)
- Topics: backdrop, cover, emby, imdb, jellyfin, letterboxd, metacritic, omdb, poster, tmdb, tvtime
- Language: Python
- Homepage:
- Size: 13.2 MB
- Stars: 38
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Better Covers
BetterCovers is a script to automaticaly generate covers and backdrops with embeded ratings, mediainfo, language, certifications, age ratings, source, production companies, etc!
## Examples
The script is made to be fully customizable, all properties can be disabled and custom cover templates can be selected based on a large number of filters!
After executing the script you have to refresh the library on Emby/Plex/Jellyfin for this to take effect! (Or configure the agent in the config file to automaticaly update the library!)
## Downloading
### Docker
The easiest option for running is using [docker](https://hub.docker.com/r/ilarramendi/bettercovers).
```
docker run -i --rm \
-v /path/to/media:/media \
-v /path/to/config:/config \
-e parameters="-w 50" `#OPTIONAL` \
-e fileMask="*" `#OPTIONAL` \
ilarramendi/bettercovers
```
### Python
Clone the project: `git clone https://github.com/ilarramendi/BetterCovers`
Install python requirments: `pip3 install requests jellyfish exif`
Install program requirments: `sudo apt install -y chromium-browser ffmpeg`
Run: `python3 BetterCovers.py '/path/to/media/*'`
## Folder structure
Each movie needs to be inside a unique folder.
Each TV show season must be inside a unique folder.
For better identification folders names can have imdb and/or tmdb ids like: `[tmdbid=123456]` or `[imdbid=123456]`
## Planned features (Please suggest more)
- [ ] Option to save images on Agent metadata folder to improve menu loading time (media images on HDD load a bit slow on emby) (linx file to another drive with linux?)
- [ ] Different themes (suggestions are apreciate)
- [ ] Use existing cover
- [ ] Add aditional mediainfo properties (dolby, ATMOS, audio channels)
- [ ] Add connection with Sonarr and Radarr api (or script on import)
- [ ] Add connection to plex api
- [ ] Add original downloaded image cache for faster cover creation (wkhtmltopdf cache not working)
- [ ] Make docker container lighter and faster
- [ ] Web Ui (WIP: [ilarramendi/BetterCovers-Frontend](https://github.com/ilarramendi/BetterCovers-Frontend))
## Config.json
[config.md](https://github.com/ilarramendi/BetterCovers/blob/main/docs/config.md)
## Parameters
`-o` Ovewrite any cover found (images are automaticaly overwriten if info changes)
`-wd /path/to/wd` Change the default working directory (where config files, images and covers are stored)
`-w number` Number of workers to use, default 20 (using too many workers can result in images not loading correctly or hitting api limits)
`--log-level number` Verbose level from 0 to 5, default 2.
`--dry` Performs a dry run, only getting metadata, not generating any image.
`--json` Save metadata to metadata.json (usefull for debugin and getting data out for other programs).
`--no-colors` Remove colors from output (Usefull for docker).