https://github.com/neodb-social/neodb
🧩 NeoDB is a self-hosted server tracking what you read/watch/listen/play, powering a global distributed community federating via ActivityPub.
https://github.com/neodb-social/neodb
activitypub books douban games goodreads hacktoberfest letterboxd mastodon movies music neodb podcasts social-network
Last synced: about 15 hours ago
JSON representation
🧩 NeoDB is a self-hosted server tracking what you read/watch/listen/play, powering a global distributed community federating via ActivityPub.
- Host: GitHub
- URL: https://github.com/neodb-social/neodb
- Owner: neodb-social
- License: agpl-3.0
- Fork: true (doubaniux/boofilsic)
- Created: 2021-09-13T18:21:19.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T19:00:39.000Z (over 1 year ago)
- Last Synced: 2024-04-13T21:16:37.238Z (over 1 year ago)
- Topics: activitypub, books, douban, games, goodreads, hacktoberfest, letterboxd, mastodon, movies, music, neodb, podcasts, social-network
- Language: Python
- Homepage: https://mastodon.social/@neodb
- Size: 39.4 MB
- Stars: 305
- Watchers: 4
- Forks: 21
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- my-awesome - neodb-social/neodb - server,movies,music,musicbrainz,openlibrary,podcasts,social-network,threads-net,tv-shows,wikidata pushed_at:2025-09 star:0.7k fork:0.0k 🧩 a self-hosted server tracking what you read/watch/listen/play, powering a global distributed community federating via ActivityPub and (a bit of) ATProto. (Python)
- awesome-activitypub - NeoDB - an ActivityPub server tracking and review what you read/watch/listen/play. (Services)
- awesome-repositories - neodb-social/neodb - 🧩 a self-hosted server tracking what you read/watch/listen/play, powering a global distributed community federating via ActivityPub and (a bit of) ATProto. (Python)
README
[](https://hosted.weblate.org/projects/neodb/neodb/)
[](https://github.com/neodb-social/neodb/releases)
[](https://hub.docker.com/r/neodb/neodb)
[](https://github.com/neodb-social/neodb/blob/main/LICENSE)
# 🧩 NeoDB
_mark the things you love._
[NeoDB](https://neodb.net) (fka boofilsic) is an open source project and free service to help users manage, share and discover collections, reviews and ratings for culture products (e.g. books, movies, music, podcasts, games and performances) in Fediverse.
[NeoDB.social](https://neodb.social) is a free instance hosted by NeoDB developers, there are more [servers](https://neodb.net/servers/) and [apps](https://neodb.net/apps/) available.
Follow us on [Fediverse](https://mastodon.online/@neodb), [Bluesky](https://bsky.app/profile/neodb.net) or join our [Discord community](https://discord.gg/QBHkrV8bxK) to share your ideas/questions/creations. Your support is essential to keep the services free and open-sourced.
[](https://mastodon.social/@neodb)
[](https://discord.gg/QBHkrV8bxK)
[](https://ko-fi.com/neodb)
## Features
- manage a shared catalog of books/movies/tv shows/music album/games/podcasts/performances
+ search or create catalog items in each category
+ one click create item with links to 3rd party sites:
* Goodreads
* IMDB
* The Movie Database
* Douban
* Google Books
* Discogs
* Spotify
* Apple Music
* Bandcamp
* Steam
* IGDB
* Bangumi
* Board Game Geek
* Archive of Our Own
* WikiData
* Open Library
* WorldCat
* Musicbrainz
* any RSS link to a podcast
+ Search from some of sites above
- logged in users can manage their collections:
+ mark an item as wishlist/in progress/complete/dropped
+ rate and write notes and reviews for an item
+ create tags for an item, either privately or publicly
+ create and share a collection of items
+ tracking progress of a list (e.g. personal reading challenges)
+ import and export full user data archive
+ import list or archives from some 3rd party sites:
* Goodreads reading list
* Letterboxd watch list
* Douban archive (via [Doufen](https://doufen.org/))
* Steam Library
- social features:
+ view home feed with friends' activities
* every activity can be set as viewable to self/follower-only/public
* eligible items, e.g. podcasts and albums, are playable in feed
+ micro-blogging: post status/photos and interact with them
+ login with other Fediverse identity and import social graph
* supported servers: Mastodon/Pleroma/Firefish/GoToSocial/Pixelfed/friendica/Takahē
+ login with Bluesky / ATProto identity and import social graph
+ login with threads.net (requires app verification by Meta)
+ share collections and reviews to Fediverse/Bluesky/Threads
- ActivityPub support
+ NeoDB users can follow and interact with users on other ActivityPub services like Mastodon and Pleroma
+ NeoDB instances communicate with each other via an extended version of ActivityPub
+ NeoDB instances may share public rating and reviews with a default relay
+ implementation is based on [Takahē](https://jointakahe.org/) server
- ATProto support
+ NeoDB is not a PDS, but may publish posts to user feed
- comprehensive API support
+ Restful API with OpenAPI specification, see `/developer/` of your instance
+ Mastodon-compatible API are available, most of Mastodon apps works out of box
- other
+ i18n: da, de, en, fr, it, pt and zh are available; contribution for more languages welcomed
## Participate an existing instance
See the list of [public servers](https://neodb.net/servers/) and [apps](https://neodb.net/apps/).
## Host your own instance
Please see [installation guide](https://neodb.net/install/).
## Contribution
- To build application with NeoDB API, documentation is available in [NeoDB API Developer Console](https://neodb.social/developer/)
- To help develop NeoDB, please see [development guide](https://neodb.net/development/) for some basics to start with
- To translate NeoDB to more languages, please join [our project on Weblate](https://hosted.weblate.org/projects/neodb/neodb/)
- Source code for [NeoDB documentation](https://neodb.net) can be found [here](https://github.com/neodb-social/neodb-doc)
## Sponsor
If you like this project, please consider donating to [NeoDB.social on ko-fi](https://ko-fi.com/neodb), or [Takahē](https://www.patreon.com/takahe) and [NiceDB](https://patreon.com/tertius) without whom this project won't be possible.