anirra

KO | EN

gitlite — search

#python #hacktoberfest #go #golang #rust #deep-learning #linux #macos #awesome #cli #awesome-list #security #ios #mcp

(★ 75)

Anirra is a completely self-hosted anime watchlist, search, and recommendations app. It allows anime enthusiasts to manage their watchlists, discover new anime, and receive personalized recommendations, all from a single platform.

anirra Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Anirra

Anirra is a completely self-hosted anime watchlist, search, and recommendations app. It allows anime enthusiasts to manage their watchlists, discover new anime, and receive personalized recommendations, all from a single platform.

## Features

- **Watchlist Management**: Keep track of the anime you plan to watch, are currently watching, or have completed.
- **Search Functionality**: Easily search for anime by title or tags.
- **Personalized Recommendations**: Get suggestions based on your watchlist and preferences.
- **Integration with Sonarr and Radarr**: Seamlessly add series and movies to your media server.
- **Convert your MAL list**: Upload your MAL XML file from [MAL XML Exporter](https://myanimelist.net/panel.php?go=export), and easily move to using Anirra.
- **Rate your Anime**: Easily rate your anime when you're done watching.
- **Export your watchlist**: Easily export your watchlist if you were to ever choose to leave Anirra.

## Screenshots

To give you a better idea of what Anirra looks like, here are some screenshots of the app in action:

### Main Page (Logged In)
![Main Page](https://raw.githubusercontent.com/jaypyles/anirra/main/docs/images/main-page-logged-in.png)

### Anime Page
![Anime Page](https://raw.githubusercontent.com/jaypyles/anirra/main/docs/images/anime-page.png)

### Search Page
![Search Page](https://raw.githubusercontent.com/jaypyles/anirra/main/docs/images/search-page.png)

### Watchlist Page
![Watchlist Page](https://raw.githubusercontent.com/jaypyles/anirra/main/docs/images/watchlist-page.png)

### Sonarr Integration
![Sonarr](https://raw.githubusercontent.com/jaypyles/anirra/main/docs/images/sonarr.png)

### Radarr Integration
![Radarr](https://raw.githubusercontent.com/jaypyles/anirra/main/docs/images/radarr.png)

## Launching the App

To launch the app, use the `docker-compose.yml` file located in the root directory of the project. Ensure you have `make` and `docker` installed, then run the following command in your terminal:

```bash
make pull up
```

### Default User Credentials

The default user credentials are:

```
user: admin
password: admin
```

But if you would like to, you can create a new user with a more secure password.

## Configuration

There are a few set of environment variables you can use to customize the app (all are completely optional).

```
APP_LEVEL=(DEV || PROD) # defaults to PROD in the docker-compose.yml
DATABASE_URL=whatever you want here if you don't want to use the sqlite database that the app comes with
JSON_DATA_PATH=wherever the `anime_offline_database.json` is located, by default its at /data
JWT_SECRET=a secret used to encode the user jwt
API_URL=if you somehow got the api to run anywhere else
NEXTAUTH_SECRET=a secret used to encode the next jwt
```

### Sonarr and Radarr configuration

Setup the `config.yaml` at the root of the project:

```yaml
sonarr:
  url: http://<ip_or_address>:<port>
  api_key: 123456

radarr:
  url: http://<ip_or_address>:<port>
  api_key: 123456
```

## Example Docker Compose

```yaml
services:
  anirra:
    container_name: anirra
    image: jpyles0524/anirra:latest
    build:
      context: .
      dockerfile: Dockerfile
    command: bash /start.sh
    environment:
      - APP_LEVEL=PROD
      - NEXTAUTH_URL=<your_deployment_url>
    volumes:
      - ./data:/project/data
      - ./config.yaml:/project/config.yaml
    ports:
      - 3000:3000
      - 8000:8000
```

## Coming Soon

- **Mobile Support**: Simplified UI for mobile viewing
- **Watchlist Rating**: Rate the anime and get better recommendations based off of what you like
- **Jellyfin Integration**: Automatically sync the anime you are watching on Jellyfin

anirra

anirra Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

anirra

anirra Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README