Skip to content

goniszewski/grimoire

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Grimoire Logo

Grimoire

Bookmark manager for the wizards πŸ§™

GitHub License GitHub Actions Workflow Status GitHub Release Docker Pulls

Important

Version 0.4 introduces a new approach for data storage and user authorization. If you are upgrading from version 0.3.X you may want to utilize the built-in migration tool (read more).

Glimpse into the magical book of your forbidden knowledge - Grimoire! πŸ“–πŸ’«

Unleash your inner sorcerer and conquer the chaos of bookmarks! With Grimoire, you'll have a bewitching way to store and sort your enchanted links.

But wait, there's more!

Transmute your saved pages into juicy content snippets with our mystical extraction feature. Embrace the magic, tame the clutter, and let Grimoire be your mystical companion in the vast library of the web.

It's time to conjure up some organization! πŸ“šβœ¨

Features

  • add and organize bookmarks easily πŸ”–
  • create new user accounts, each with their own bookmarks, categories and tags πŸ™‹
  • fuzzy search through bookmarks πŸ”
  • supports tags and categories 🏷️
  • fetch metadata from websites, store it locally and update it when needed 🌐
  • add your personal notes to bookmarks πŸ“
  • integration API to add bookmarks from other sources 🧰
  • embrace the night with a dark mode πŸŒ™
  • and stay productive using our official browser extension, grimoire companion (available here) πŸͺ„

Screenshots

Light Mode Dark Mode
Only unread Show only unread Adding new bookmark Adding new bookmark
User Profile view User Profile view Bookmark details Bookmark details

More screenshots can be found in the screenshots directory.

Installation

Run using Docker Compose (recommended)

Prerequisites

Steps

  1. Create a docker-compose.yml file with the following content:
services:
  grimoire:
    image: goniszewski/grimoire:latest # or change from 'latest' to 'preview' to use the latest preview version
    container_name: grimoire
    restart: unless-stopped
    environment:
      - PORT=5173
      - PUBLIC_HTTPS_ONLY=false
      - PUBLIC_SIGNUP_DISABLED=false
    volumes:
      - grimoire_data:/app/data/
    build:
      context: .
      dockerfile: Dockerfile
    healthcheck:
      test: wget --no-verbose --tries=1 --spider http://localhost:$PORT/api/health || exit 1
      interval: 30s
      timeout: 10s
      retries: 3
    ports:
      - '${PORT:-5173}:${PORT:-5173}'
volumes:
  grimoire_data:
  1. [Optional] Update the environment variables to match your needs.
  2. Run the app using docker compose up -d command.

Note

For the recommended setup, only the docker-compose.yml file is required.

Run app using Node

Prerequisites

Steps

# Clone the repository
git clone https://github.com/goniszewski/grimoire

# Rename the `.env.example` file to `.env`
# "mv .env.example .env" on Linux/MacOS, "ren .env.example .env" on Windows

# Install the dependencies
pnpm i

# Run the app
chmod +x ./run-dev.sh && ./run-dev.sh

Tip

Although the above setups are intended for development, they are also suitable for daily use. For a better experience, it is recommended to use a Node.js process manager, such as PM2.

Development

Check out the development guide to learn how to set up the project for development.

Roadmap

  • Initial relase (0.1.0) πŸš€
  • Official Docker image 🐳
  • Add Integration API 🧰
  • Official browser extension (repository) πŸͺ„
  • Bookmark import and export features πŸ’Ό
  • AI features, like generated descriptions and tags suggestions πŸ€–
  • Public User profiles & bookmark sharing 🌍
  • Flows - a way to keep bookmarks in a session-like order with related notes (e.g. for learning, research, etc.) ✨
  • ...and more to come! πŸ§™

We're open to suggestions and feature requests! If you have an idea for a feature, please open an issue or start a discussion.

Contributing

If you want to contribute to the project, please read the contributing guide.

License

This project is licensed under the MIT License.

Credits

Special thanks to: @extractus/article-extractor, Bun, DaisyUI, Drizzle, Fuse.js, Lucia, MetaScraper, PocketBase, sanitize-html, SvelteKit, Svelte Select, Svelte French Toast, Swagger UI, Tabler Icons, Tailwind CSS, url-metadata