https://github.com/jorenn92/Maintainerr

Looks and smells like Overseerr, does the opposite. Maintenance tool for the Plex ecosystem
https://github.com/jorenn92/Maintainerr

docker maintenance movies overseerr plex plex-media-server radarr sonarr tv-series tv-shows

Last synced: about 2 months ago
JSON representation

Looks and smells like Overseerr, does the opposite. Maintenance tool for the Plex ecosystem

• Host: GitHub
• URL: https://github.com/jorenn92/Maintainerr
• Owner: jorenn92
• License: mit
• Created: 2022-01-12T08:46:37.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-21T22:17:25.000Z (2 months ago)
• Last Synced: 2024-10-22T16:30:32.039Z (about 2 months ago)
• Topics: docker, maintenance, movies, overseerr, plex, plex-media-server, radarr, sonarr, tv-series, tv-shows
• Language: TypeScript
• Homepage: https://maintainerr.info
• Size: 6.51 MB
• Stars: 815
• Watchers: 5
• Forks: 15
• Open Issues: 35
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-homelab - Maintainerr
• awesome-arr - Maintainerr - Looks and smells like Overseerr, does the opposite. Maintenance tool for the Plex ecosystem. (Complimenting Apps)

README

        


  





  

  

  

  

  

  

  

  

  

  

  

  

  



Maintainerr makes managing your media easy.

- Do you hate being the janitor of your server?

- Do you have a lot of media that never gets watched?

- Do your users constantly request media, and let it sit there afterward never to be touched again?

If you answered yes to any of those questions.. You NEED Maintainerr.

It's a one-stop-shop for handling those outlying shows and movies that take up precious space on your server.

# Features

- Configure rules specific to your needs, based off of several available options from Plex, Overseerr, Radarr, Sonarr and Tautulli.

- Manually add media to a collection, in case it's not included after rule execution. (one-off items that don't match a rule set)

- Selectively exclude media from being added to a collection, even if it matches a rule.

- Show a collection, containing rule matched media, on the Plex home screen for a specific duration before deletion. Think "Leaving soon".

- Optionally, use a manual Plex collection, in case you don't want Maintainerr to add & remove Plex collections at will.

- Manage media straight from the collection within Plex. Maintainerr will sync and add or exclude media to/from the internal collection.

- Remove or unmonitor media from \*arr

- Clear requests from Overseerr

- Delete files from disk




Currently, Maintainerr supports rule parameters from these apps :

- Plex

- Overseerr

- Radarr

- Sonarr

- Tautulli

# Preview

![image](./ui/public/screenshots/overview_screenshot.png)

![image](./ui/public/screenshots/rules_screenshot.png)

![image](./ui/public/screenshots/collections_screenshot.png)

![image](./ui/public/screenshots/rule_example_screenshot.png)

# Installation

Docker images for amd64 & arm64 are available under [jorenn92/maintainerr](https://hub.docker.com/r/jorenn92/maintainerr) and ghcr.io/jorenn92/maintainerr. 


Data is saved within the container under /opt/data, it is recommended to tie a persistent volume to this location in your docker command/compose file.

Make sure this directory is read/writeable by the user specified in the 'user' instruction. If no 'user' instruction is configured, the volume should be accessible by UID:GID 1000:1000.

For more information, visit the [installation guide](https://docs.maintainerr.info/Installation).

Docker run:

```Yaml

docker run -d \

--name maintainerr \

-e TZ=Europe/Brussels \

-v ./data:/opt/data \

-u 1000:1000 \

-p 6246:6246 \

--restart unless-stopped \

ghcr.io/jorenn92/maintainerr:latest

```

Docker-compose:

```Yaml

version: '3'

services:

    maintainerr:

        image: ghcr.io/jorenn92/maintainerr:latest # or jorenn92/maintainerr:latest

        container_name: maintainerr

        user: 1000:1000

        volumes:

          - type: bind

            source: ./data

            target: /opt/data

        environment:

          - TZ=Europe/Brussels

#      - DEBUG=true # uncomment to enable debug logs

        ports:

          - 6246:6246

        restart: unless-stopped

```

# Documentation

[For more information, please consult the documentation](https://docs.maintainerr.info/)

# Features

[To get an indication of which features are most desired, you can vote for them](https://features.maintainerr.info/?view=most-wanted)

# Credits

Maintainerr is heavily inspired by Overseerr. Some parts of Maintainerr's code are plain copies. Big thanks to the Overseerr team for creating and maintaining such an amazing app!

Please support them at