Skip to content

wwmoraes/anilistarr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

anilistarr

anilist custom list provider for sonarr/radarr

Go Reference GitHub Issues GitHub Pull Requests Codecov

GitHub branch status Integration Release Security Documentation

License CII Best Practices

Docker Image Size (latest semver) Docker Image Version (latest semver) Docker Pulls

built with nix


📝 Table of Contents

🧐 About

Converts an Anilist user watching list to a custom list format which *arr apps support.

It works by fetching the user info directly from Anilist thanks to its API, and converts the IDs using community-provided mappings.

Try it out on a live instance at https://anilistarr.fly.dev/. For API details check either the source Swagger definition or the generated online version here.

🏁 Getting Started

Clone the repository and use go run ./cmd/handler/... to get the REST API up.

🔧 Running the tests

Explain how to run the automated tests for this system.

🎈 Usage

Configuration in general is a WIP. The code supports distinct storage and cache options and has built-in support for different caches and stores. The handler needs flags/configuration file support to allow switching at runtime.

Implemented solutions:

  • Cache
    • Badger
    • Bolt (no TTL support tho)
    • Redis
  • Store
    • Badger
    • SQL (model generated for SQLite, should work for others but YMMV)

🚀 Deployment

The handler binary is statically compiled and serves both the REST API and the telemetry to an OTLP endpoint. Extra requirements depend on which storage and cache technologies you've chosen; e.g. using SQLite/Bolt requires a database file. The Docker image provided contains the handler alone, for instance.

🔧 Built Using

  • Golang - Base language
  • Chi - net/HTTP-compatible router that doesn't suck
  • genqlient - type-safe GraphQL client generator
  • xo - SQL client code generator
  • Open Telemetry - Observability

🧑‍💻 Authors

🎉 Acknowledgements