Skip to content

bookwyrm-social/bookwyrm

Folders and files

NameName
Last commit message
Last commit date
Feb 14, 2025
Jan 11, 2025
Jul 28, 2024
Aug 28, 2023
Mar 21, 2024
Mar 24, 2024
Mar 18, 2024
Oct 17, 2024
Mar 29, 2024
Mar 18, 2024
Mar 16, 2022
Mar 4, 2021
Mar 5, 2023
Aug 23, 2021
Apr 24, 2024
Apr 5, 2021
Apr 6, 2021
Apr 15, 2024
Mar 1, 2022
Oct 17, 2023
Jul 27, 2024
Mar 4, 2021
Mar 2, 2024
Sep 25, 2023
Apr 28, 2021
Mar 26, 2024
Jun 30, 2022
Mar 25, 2024
Oct 21, 2023
Feb 10, 2024
Jul 22, 2023
Jul 22, 2023
Jul 22, 2023
Oct 7, 2021
Sep 9, 2024
Sep 21, 2020
Sep 8, 2023
Mar 20, 2024
Jul 28, 2024
Jan 23, 2024
Feb 14, 2025

Repository files navigation

BookWyrm

Run Python Tests Pylint

BookWyrm is a social network for tracking your reading, talking about books, writing reviews, and discovering what to read next. Federation allows BookWyrm users to join small, trusted communities that can connect with one another, and with other ActivityPub services like Mastodon and Pleroma.

Links

Mastodon Follow

About BookWyrm

BookWyrm is a platform for social reading. You can use it to track what you're reading, review books, and follow your friends. It isn't primarily meant for cataloguing or as a data-source for books, but it does do both of those things to some degree.

Federation

BookWyrm is built on ActivityPub. With ActivityPub, it inter-operates with different instances of BookWyrm, and other ActivityPub compliant services, like Mastodon. This means you can run an instance for your book club, and still follow your friend who posts on a server devoted to 20th century Russian speculative fiction. It also means that your friend on mastodon can read and comment on a book review that you post on your BookWyrm instance.

Federation makes it possible to have small, self-determining communities, in contrast to the monolithic service you find on GoodReads or Twitter. An instance can be focused on a particular interest, be just for a group of friends, or anything else that brings people together. Each community can choose which other instances they want to federate with, and moderate and run their community autonomously. Check out https://runyourown.social/ to get a sense of the philosophy and logistics behind small, high-trust social networks.

Features

Post about books

Compose reviews, comment on what you're reading, and post quotes from books. You can converse with other BookWyrm users across the network about what they're reading.

Track reading activity

Keep track of what books you've read, and what books you'd like to read in the future.

Federation with ActivityPub

Federation allows you to interact with users on other instances and services, and also shares metadata about books and authors, which collaboratively builds a decentralized database of books.

Privacy and moderation

Users and administrators can control who can see their posts and what other instances to federate with.

Tech Stack

Web backend

Front end

  • Django templates
  • Bulma.io css framework
  • Vanilla JavaScript, in moderation

Deployment

Set up BookWyrm

The documentation website has instruction on how to set up BookWyrm in a developer environment or production.