Repolode
neodb-social

neodb-social/neodb

A self-hosted server for tracking books, movies, music, games and podcasts, with reviews and social sharing over ActivityPub and ATProto.

Open-source alternative to:GoodreadsLetterboxd

Stars
906
Forks
69
Open issues
91
Last commit
2 days ago

What is it?

NeoDB is a self-hosted server for managing collections, reviews and ratings of cultural products such as books, movies, TV shows, music albums, games, podcasts and performances. Users can mark items as wishlist, in progress, complete or dropped, write notes and reviews, tag items, and build shareable collections. A shared catalog lets items be created in one click with links to many third-party sites such as Goodreads, IMDB, MusicBrainz and Steam.

Socially, NeoDB instances federate with the Fediverse through an extended ActivityPub implementation based on the Takahē server, and users can log in with Mastodon-family or Bluesky identities and import their social graph. It also stores records to ATProto PDS and publishes posts to users' feeds. Users can follow and interact with accounts on Mastodon and Pleroma, and a Mastodon-compatible API lets most Mastodon apps work with it.

The project offers a public instance at neodb.social as well as installation guides for hosting your own. It includes a RESTful API with an OpenAPI specification, data import and export, and support for several languages.

Key features

  • 01Tracks books, movies, TV, music, games, podcasts and performances with status, ratings and reviews.
  • 02Imports lists from Goodreads, Letterboxd, Douban, StoryGraph, Hardcover and Steam.
  • 03Federates with Mastodon, Pleroma and other Fediverse servers via ActivityPub.
  • 04Supports login with Bluesky / ATProto identities and publishing to ATProto.
  • 05Provides a RESTful API with OpenAPI docs and a Mastodon-compatible API.

Use cases

  • Keeping a personal log of books, shows and games with reviews and tags.
  • Running a private or community instance for a group that shares cultural reviews.
  • Building a Fediverse or Bluesky-connected app that uses the NeoDB API.
  • Migrating reading or watch lists from Goodreads, Letterboxd or Douban.

Quick start

  1. 1

    Read the installation guide linked in the README to host your own instance

  2. 2

    Or join an existing public server listed on the NeoDB servers page

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires derivative network services to share their source code.
  • Self-hosting setup is described only in an external installation guide, not in the README itself.

In collections

Topics

#activitypub#fediverse#atproto#self-hosted#reviews#book-tracking#media-tracking#python#bluesky#books

FAQ

What is neodb?
A self-hosted server for tracking books, movies, music, games and podcasts, with reviews and social sharing over ActivityPub and ATProto. NeoDB is a self-hosted server for managing collections, reviews and ratings of cultural products such as books, movies, TV shows, music albums, games, podcasts and performances. Users can mark items as wishlist, in progress, complete or dropped, write notes and reviews, tag items, and build shareable collections. A shared catalog lets items be created in one click with links to many third-party sites such as Goodreads, IMDB, MusicBrainz and Steam.
Is neodb free to use? What license does it have?
neodb is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is neodb still maintained?
Actively maintained. The last commit to neodb was on Nov 5, 2026.
What can I use neodb for?
Keeping a personal log of books, shows and games with reviews and tags. Running a private or community instance for a group that shares cultural reviews. Building a Fediverse or Bluesky-connected app that uses the NeoDB API. Migrating reading or watch lists from Goodreads, Letterboxd or Douban.
How do I install neodb?
Read the installation guide linked in the README to host your own instance Or join an existing public server listed on the NeoDB servers page
Where can I get neodb?
The source code and installation instructions are on GitHub: https://github.com/neodb-social/neodb

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects