Skip to main content

Bouquin

Bouquin logo

Introduction

Bouquin ("Book-ahn") is a notebook and planner application written in Python, Qt and SQLCipher.

It is designed to treat each day as its own 'page', complete with Markdown rendering, tagging, search, reminders and time logging for those of us who need to keep track of not just TODOs, but also how long we spent on them.

For those who rely on that time logging for work, there is also an Invoicing feature that can generate invoices of that time spent.

There is also support for embedding documents in a file manager.

It uses SQLCipher as a drop-in replacement for SQLite3.

This means that the underlying database for the notebook is encrypted at rest.

To increase security, the SQLCipher key is requested when the app is opened, and is not written to disk unless the user configures it to be in the settings.

There is deliberately no network connectivity or syncing intended, other than the option to send a bug report from within the app, or optionally to check for new versions to upgrade to.

Screenshots

General view

Bouquin screenshot

History panes

Screenshot of Bouquin History Preview Pane Screenshot of Bouquin History Diff Pane

Tags

Screenshot of Bouquin Tag Manager screen

Time Logging

Screenshot of Bouquin Time Log screens

Statistics

Bouquin statistics

Features

  • Data is encrypted at rest
  • Encryption key is prompted for and never stored, unless user chooses to via Settings
  • All changes are version controlled, with ability to view/diff versions, revert or delete revisions
  • Tabs are supported - right-click on a date from the calendar to open it in a new tab.
  • Automatic rendering of basic Markdown syntax
  • Basic code block editing/highlighting
  • Ability to collapse/expand sections of text
  • Ability to increase/decrease font size
  • Images are supported
  • Search all pages, or find text on current page
  • Automatic periodic saving (or explicitly save)
  • Automatic locking of the app after a period of inactivity (default 15 min)
  • Rekey the database (change the password)
  • Export the database to json, html, csv, markdown or .sql (for sqlite3)
  • Backup the database to encrypted SQLCipher format (which can then be loaded back in to a Bouquin)
  • Dark and light theme support
  • Automatically generate checkboxes when typing 'TODO'
  • It is possible to automatically move unchecked checkboxes from the last 7 days to the next day.
  • English, French and Italian locales provided
  • Ability to set reminder alarms (which will be flashed as the reminder or can be sent as webhooks/email notifications)
  • Ability to log time per day for different projects/activities, pomodoro-style log timer, timesheet reports and invoicing of time spent
  • Ability to store and tag documents (tied to Projects, same as the Time Logging system). The documents are stored embedded in the encrypted database.
  • Add and manage tags on pages and documents

How to install

Unless you are using the Debian option below:

  • Make sure you have libxcb-cursor0 installed (on Debian-based distributions) or xcb-util-cursor (RedHat/Fedora-based distributions).
  • If downloading from my Forgejo's Releases page, you may wish to verify the GPG signatures with my GPG key.

Debian 13 ('Trixie')

sudo mkdir -p /usr/share/keyrings
curl -fsSL https://mig5.net/static/mig5.asc | sudo gpg --dearmor -o /usr/share/keyrings/mig5.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/mig5.gpg] https://apt.mig5.net $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/mig5.list
sudo apt update
sudo apt install bouquin

Fedora 42

sudo rpm --import https://mig5.net/static/mig5.asc

sudo tee /etc/yum.repos.d/mig5.repo > /dev/null << 'EOF'
[mig5]
name=mig5 Repository
baseurl=https://rpm.mig5.net/$releasever/rpm/$basearch
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://mig5.net/static/mig5.asc
EOF

sudo dnf upgrade --refresh
sudo dnf install bouquin

From PyPi/pip

  • pip install bouquin

From AppImage

  • Download the Bouquin.AppImage from the Releases page, make it executable with chmod +x, and run it.

From source

  • Clone this repo or download the tarball from the releases page
  • Ensure you have poetry installed
  • Run poetry install to install dependencies
  • Run poetry run bouquin to start the application.

Alternatively, you can download the source code and wheels from Releases as well.

Metadata

Release files for bouquin 0.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bouquin 0.10.0
File Size Uploaded
bouquin-0.10.0.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for bouquin 0.10.0
File Interpreter ABI Platform
bouquin-0.10.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.2 MB

Release files / bouquin-0.10.0.tar.gz

Download URL bouquin-0.10.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
d258bb1cc8e52bdc81bfbba51b47d117c82452bee9b63ffc17940a5cf191150c
BLAKE2b-256 checksum
How to use checksums
5706278254d9210d81bf5fdd643371412a2e856693b9e5215f76cfdef1bce087
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.13.5 Linux/6.18.44-1.qubes.fc41.x86_64

Release files / bouquin-0.10.0-py3-none-any.whl

Download URL bouquin-0.10.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7f11cc1924d3914ca3f57d8e697ab10bddf90909f998fec18c77a3e13c620497
BLAKE2b-256 checksum
How to use checksums
b07b862937742e824e7ceedfdb27a9750a66a01f13011838e0af52e4e70e4975
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.13.5 Linux/6.18.44-1.qubes.fc41.x86_64

Release history Release notifications | RSS feed

This release

0.10.0 This release

2 release files

0.9.0

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.5

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.4

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page