Giter Club home page Giter Club logo

reiverr's Introduction

Reiverr

Reiverr is a project that aims to create a single UI for interacting with TMDB, Jellyfin, Radarr and Sonarr, as well as be an alternative to Overseerr.

This project is still in alpha, and many features are still missing. Contributions are welcome! See contributing for more information.

Demo Videi

List of major featuers

TMDB Discovery:

  • Discover trending movies and TV shows
  • Browse movies and TV shows by genre or network
  • View details about movies and TV shows, such as cast, crew, ratings & a trailer.
  • Movie & TV show search

Local Library & Playback

  • Stream Movies & TV shows (from Jellyfin library)
  • Create requests for movies & TV shows in Radarr & Sonarr
  • Manage local library files
  • View Radarr & Sonarr stats (disk space, items, etc.)

For a list of planned features & known bugs, see Reiverr Taskboard.

Installation

The easiest and the recommended way to insstall Reiverr is via docker-compose. Make sure to update the api keys and base URLs to match your setup.

Radarr & Sonarr API keys can be found under Settings > General in their respective web UIs. Jellyfin API key is located under Administration > Dashboard > Advanced > API Keys in the Jellyfin Web UI.

version: '3.8'

name: reiverr

services:
  reiverr:
    image: ghcr.io/aleksilassila/reiverr:latest
    container_name: reiverr
    ports:
      - 9494:9494
    environment:
      PUBLIC_RADARR_API_KEY: yourapikeyhere
      PUBLIC_RADARR_BASE_URL: http://127.0.0.1:7878
      PUBLIC_SONARR_API_KEY: yourapikeyhere
      PUBLIC_SONARR_BASE_URL: http://127.0.0.1:8989
      PUBLIC_JELLYFIN_API_KEY: yourapikeyhere
      PUBLIC_JELLYFIN_BASE_URL: http://127.0.0.1:8096
    restart: unless-stopped

Reiverr will be accessible via port 9494 by default.

If you have any questions or run into issues or bugs, you can start a discussion or open an issue.

Other Platforms

The roadmap includes plans to support the following platforms in the future:

  • Windows Desktop App
  • MacOS Desktop App
  • Android TV / TizenOS

Contributing

Unlike the most Servarr projects, this one is built with Svelte and SvelteKit. If you haven't used Svelte before, don't worry, this was my first Svelte project too. I'd recommend reading the official Svelte tutorial to get started.

To see a list of missing features & known bugs that you can help with, see Reiverr Taskboard. Feel free to also create your own issues for bug reports or feature requests, as well as discussions for general questions.

Before you contribute:

  • If you are taking on an existing bug or feature ticket, please comment on the issue or mark yourself as an assignee to avoid multiple people working on the same thing.
  • If the ticket is vague or missing information, please ask for clarification in the comments.
  • UI style must match the rest of the project and it is a good idea to discuss the design beforehand, especially for larger design choices (issues labelled with "design")

I'm not a designer, so if you have any ideas for improving the UI, I'd love to learn about them. If you are a designer and would like to help, contributions are much appreciated!

Development

To get started with development:

  1. Clone the repo
  2. Add and populate .env file
  3. Run npm install
  4. Run npm run dev

Alternatively, you can run docker-compose up.

Example .env file:

# The PUBLIC_ prefix is required for SvelteKit to expose the variable to the web browser.
# If you are exposing the server to the internet (not recommended), you should use HTTPS.

# Fill in the blanks and change the base URLs to match your setup.

PUBLIC_RADARR_API_KEY=yourapikeyhere
PUBLIC_RADARR_BASE_URL=http://127.0.0.1:7878

PUBLIC_SONARR_API_KEY=yourapikeyhere
PUBLIC_SONARR_BASE_URL=http://127.0.0.1:8989

PUBLIC_JELLYFIN_API_KEY=yourapikeyhere
PUBLIC_JELLYFIN_BASE_URL=http://127.0.0.1:8096

For Webstorm users: I'd recommend using VS Code as it has way better Svelte Typescript support.

Useful resources:

Additional Screenshots

Landing Page

Series Page

Library Page

reiverr's People

Contributors

aleksilassila avatar oxixes avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.