A personal library based on Goodreads data.
- Have Docker installed
- Clone this repo locally or Download zip and extract
- Open a terminal and change directory to SoloScribe-main
- Run
docker compose up -d - Open a browser and go to http://127.0.0.1:8000/
- The easiest way to get the app running on Windows is to install Docker Desktop https://www.docker.com/products/docker-desktop/
- If you have git locally installed you can use
git clone https://github.com/yamesyung/SoloScribe.git - If you don't have git locally installed you can download the source code from Code -> Download ZIP and extract to your preferred location
- Open Docker Desktop and make sure docker engine is running
- Go inside to extracted folder, open a console (Shift + Right click -> Open powershell) and type
docker compose up -d - Open a browser and go to http://127.0.0.1:8000/
- To close the app you can type
docker compose downin the same powershell and close the docker engine from Docker Desktop
There are 2 ways to add books in the library:
- Profile -> Import data -> Goodreads file (can use the Goodreads export library file and is compatible with library export csv file)
- Profile -> Add new book (which adds a singular book, based on its url, to one of the predefined shelves)
I also included in the demo directory an export file to get started with the project.
- List of books and authors from Goodreads library
- Quotes page, where you can search, filter and mark quotes as favorite
- Book gallery (an interactive page where you can search, filter, rate and review shelved books)
- Advanced stats for books and authors
- Map view (using the Setting/Places field in book data; Named Entity Recognition for Geo Political Entity based on author's description)
- Word cloud based on books' descriptions grouped in genres (books with language = "English")
- Timeline view for authors with known birth/death date
- Influence graph for authors (some authors may appear more than once, ex: Kafka and Franz Kafka)
- A recommendations page with curated books
- Export function: csv file
- Export function: zip file structured as Obsidian vault
- Theme support
Notes:
- Markdown syntax works when reviewing in book gallery, so you can add tags or create additional content
- Importing the csv file won't overwrite ratings and review in the database
There are 3 "official" themes. The "custom" theme allows for more customization options.
If these are not enough you can create your own theme in the static/themes folder. Django sends the html and htmx interactions with the backend and loads the static files from the selected theme folder. This means you have a lot of freedom to style this library with your own static files and share them with the community. Keep in mind that the app is still in development so html structure might change.
