Pickarr is a service (distributed in a docker image) that keeps an eye on trending movies/tvshows on IMDb and recommend the ones that might be of interest, according to some user defined criteria. The recommendations are sent via Telegram messages. For each movie/tvshow recommendation it includes some related data:
- Title and year of release;
- Studio/network
- Synopsis
- IMDb rating and number of votes
- Popularity ranking
- Original language
- Genres
- Most popular actors
- Poster image
and provides the following actions:
Here are some example snippets to show how one can get started creating a container.
docker-compose.yml
version: "2.4"
pickarr:
container_name: pickarr
image: rrvieir4/pickarr:latest
restart: always
ports:
- "7877:7877"
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Lisbon
- RADARR_URL=http://127.0.0.1:7878
- RADARR_API_KEY=<your radarr api key>
- RADARR_QUALITY_PROFILE_NAME=Ultra-HD
- SONARR_URL=http://127.0.0.1:8989
- SONARR_API_KEY=<your sonarr api key>
- SONARR_QUALITY_PROFILE_NAME=Ultra-HD
- TMDB_API_KEY=<your tmdb api key>
- MOVIE_MIN_YEAR=2021
- MOVIE_MIN_VOTES=3000
- MOVIE_MIN_RATING=5.7
- TV_SHOW_MIN_YEAR=2021
- TV_SHOW_MIN_VOTES=3000
- TV_SHOW_MIN_RATING=7.5
- LANGUAGE_BLACKLIST=hi,ta,te
- TAG_NAME=pickarr
- REFRESH_INTERVAL=86400
- ACTION_ADDRESS=http://127.0.0.1:7877
- TELEGRAM_USER_TOKEN=<your telegram user token>
- TELEGRAM_CHAT_ID=<your telegram chat id>
volumes:
- /your/path/to/pickarr/data:/dataLaunch:
foo@bar:~$ docker-compose --file docker-compose.yml up -d --remove-orphansdocker run -d \
--name=pickarr \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=Europe/Lisbon \
-e RADARR_URL='http://127.0.0.1:7878' \
-e RADARR_API_KEY=<your radarr api key> \
-e RADARR_QUALITY_PROFILE_NAME=Ultra-HD \
-e SONARR_URL='http://127.0.0.1:8989' \
-e SONARR_API_KEY=<your sonarr api key> \
-e SONARR_QUALITY_PROFILE_NAME=Ultra-HD \
-e TMDB_API_KEY=<your tmdb api key> \
-e MOVIE_MIN_YEAR=2021 \
-e MOVIE_MIN_VOTES=3000 \
-e MOVIE_MIN_RATING=5.7 \
-e TV_SHOW_MIN_YEAR=2021 \
-e TV_SHOW_MIN_VOTES=3000 \
-e TV_SHOW_MIN_RATING=7.5 \
-e LANGUAGE_BLACKLIST='hi,ta,te' \
-e TAG_NAME=pickarr \
-e REFRESH_INTERVAL=86400 \
-e ACTION_ADDRESS='http://127.0.0.1:7877' \
-e TELEGRAM_USER_TOKEN=<your telegram user token> \
-e TELEGRAM_CHAT_ID=<your telegram chat id> \
-p 7877:7877 \
-v /your/path/to/pickarr/data:/data \
--restart unless-stopped \
rrvieir4/pickarr:latest| Name | Optional? | Default | Description |
|---|---|---|---|
| RADARR_URL | No | N/A | Radarr address |
| RADARR_API_KEY | No | N/A | Radarr API Key |
| RADARR_QUALITY_PROFILE_NAME | No | N/A | Radarr quality profile name (case-sensitive) for the movies added by pickarr |
| SONARR_URL | No | N/A | Sonarr address |
| SONARR_API_KEY | No | N/A | Sonarr API Key |
| SONARR_QUALITY_PROFILE_NAME | No | N/A | Sonarr quality profile name (case-sensitive) for the tvshows added by pickarr |
| TMDB_API_KEY | No | N/A | TMDb API Key |
| DEFAULT_TAG_NAME | Yes | pickarr | Tag name for the movies/tvshows added by pickarr |
| REFRESH_INTERVAL | Yes | 86400 | Popular list refresh interval (in seconds) |
| ACTION_ADDRESS | No | N/A | pickarr address |
| TELEGRAM_USER_TOKEN | No | N/A | Your telegram user token |
| TELEGRAM_CHAT_ID | No | N/A | Your telegram chat id |
| MOVIE_MIN_YEAR | Yes | 2021 | Movie's minimum release year to be eligible for recommendation |
| MOVIE_MIN_VOTES | Yes | 3000 | Movie's minimum number of votes to be eligible for recommendation |
| MOVIE_MIN_RATING | Yes | 5.7 | Movie's minimum rating to be eligible for recommendation |
| TV_SHOW_MIN_YEAR | Yes | 2021 | Tvshow's minimum release year to be eligible for recommendation |
| TV_SHOW_MIN_VOTES | Yes | 3000 | Tvshow's minimum number of votes to be eligible for recommendation |
| TV_SHOW_MIN_RATING | Yes | 7.5 | Tvshow's minimum release year to be eligible for recommendation |
| LANGUAGE_BLACKLIST | Yes | empty | Movies/TV Shows with an original language contained in this list are not recommended. This list consists in a ISO 639-1 two-letter language code separated by comma (e.g: hi,ta,te) |
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent