hyprtodo 0.1.1

A todo list widget for Hyprland

hyprtodo

System tray integration - Quick access from your system tray Vim-like keybindings - Navigate with j/k Customizable theme - Edit CSS to match your desktop Simple and fast - Lightweight TUI interface

Installation

Linux

Using pipx (recommended):

pipx install hyprtodo

Using pip:

pip install hyprtodo

Windows

System Tray integration is not supported with windows. Only running the application

Clone the repository:

git clone https://github.com/williamj48/hyprtodo.git
cd hyprtodo
python3 hyprtodo

Usage

Simply run:

hyprtodo

This will create a system tray icon. Click the icon to open your todo list in a terminal window.

Keybindings:

• j / k - Move down/up
• Enter - Add new todo
• Space - Toggle selection
• Ctrl+C / q - Quit
• Esc - Unfocus input

Click the "Commit" button or press Enter in the input field to save changes.

Configuration

Todo Storage

Your todos are stored at:

~/.config/hypr/hyprtodo/todo.txt

Do not edit this file. It is meant to only be accessed through the application

Custom Styling

The CSS theme file is automatically created at:

~/.config/hyprtodo/custom.tcss

Edit this file to customize colors, borders, and styling to match your desktop theme.

Terminal Configuration

By default, hyprtodo uses kitty as the terminal. To use a different terminal, set the TERMINAL environment variable:

export TERMINAL=alacritty
hyprtodo

Requirements

• Python 3.8+
• Linux with system tray support

Future Plans

• 🔄 Google Tasks API integration for cloud sync
• 📱 Additional export formats
• 🔔 Desktop notifications for reminders

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

William Elder - [e-mail]

Repository

[https://github.com/williamj48/hyprtodo