pytodo-qt 0.3.0

A cross-platform to-do list manager with encrypted peer-to-peer synchronization

pytodo-qt

A cross-platform to-do list manager with encrypted peer-to-peer synchronization.

Features

• Multiple lists - Organize tasks into separate lists
• Priority levels - High, normal, and low priority with color coding
• Encrypted sync - AES-256-GCM encryption with Ed25519 key exchange
• Auto-discovery - Find other instances on your network via mDNS/Zeroconf
• Dark/light themes - System-following or manual theme selection
• Cross-platform - Linux, macOS, and Windows support

Requirements

• Python 3.11 or later
• PyQt6

Installation

From PyPI

pipx install pytodo-qt    # recommended
pip install pytodo-qt     # alternative

From source

git clone https://github.com/berrym/pytodo-qt.git
cd pytodo-qt
pip install .

Development install

pip install -e ".[dev]"

Usage

pytodo-qt

Command-line options

Server Options:
  -s, --server {yes,no}    enable/disable network server
  --pull {yes,no}          allow remote pull requests
  --push {yes,no}          allow remote push requests
  -i, --ip IP              server bind address
  -p, --port PORT          server port

Discovery Options:
  -d, --discovery {yes,no} enable/disable mDNS discovery

Appearance Options:
  -t, --theme {light,dark,system}

Configuration

Configuration is stored in XDG-compliant locations:

Platform	Config	Data
Linux	~/.config/pytodo-qt/	~/.local/share/pytodo-qt/
macOS	~/Library/Application Support/pytodo-qt/	same
Windows	%APPDATA%\pytodo-qt\	same

config.toml

[database]
active_list = ""
sort_key = "priority"
reverse_sort = false

[server]
enabled = true
address = "0.0.0.0"
port = 5364
allow_pull = true
allow_push = true

[discovery]
enabled = true
service_name = ""  # defaults to pytodo-{hostname}

[appearance]
theme = "system"  # light, dark, system

Synchronization

pytodo-qt uses a secure peer-to-peer protocol for syncing between instances:

1. Discovery - Instances advertise themselves via mDNS (_pytodo._tcp.local.)
2. Key exchange - Ed25519 identity keys with X25519 ephemeral session keys
3. Encryption - All data encrypted with AES-256-GCM
4. Merge - Last-write-wins conflict resolution with UUID-based items

Identity keys are stored in your system keyring (GNOME Keyring, macOS Keychain, Windows Credential Locker).

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint and format
ruff check src/ tests/
ruff format src/ tests/

# Type check
basedpyright src/

License

GPLv3 or later. See COPYING for details.

Copyright 2024 Michael Berry [e-mail]