Skip to content

Repository files navigation

Aite Commander

Hierarchical bookmark and link manager for Windows. Organize your web links, files, programs, and scripts in a 4-level structure: Sphere > Section > Category > Link.

Features

  • 4-level hierarchy — Spheres, Sections, Categories, Links with drag & drop reordering
  • 5 link types — Web, File, Folder, Program, Script
  • Favorites & Recents — Quick-access panels in the top bar
  • Full-text search — Search by name, URL, notes, and arguments
  • Undo/Redo — Full undo stack for all operations
  • Drag & Drop — Move items between categories and reorder within the tree
  • 6 themes — Light, Dark, Dreamy Room, High Contrast, Matrix, Violet Pulse
  • 6 languages — English, Ukrainian, Russian, French, Spanish, German
  • 40+ keyboard shortcuts — Fully customizable hotkeys
  • Browser import — Import bookmarks from Chrome, Edge, Firefox HTML exports
  • Social sharing — Share links via Telegram, X, Facebook, LinkedIn, WhatsApp, Email
  • Favicon auto-fetch — Background icon downloading for web links
  • Bad URL checking — Detect and remove unreachable links
  • Database backup/restore — Automatic backups with configurable limits
  • Import/Export — Full structure, section-level, or category-level as ZIP archives
  • HiDPI support — High DPI scaling

Requirements

  • Windows 10/11
  • Python 3.12+

Installation

# Clone the repository
git clone https://github.com/codebdbd/aitecommander.git
cd aitecommander

# Create and activate virtual environment
python -m venv .venv
.venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Running

python -m app.main

Or double-click aitecommander.bat.

Command-line options

Option Description
--debug Enable debug mode
--log-level LEVEL Set log level (DEBUG, INFO, WARNING, ERROR)
--no-gui Run without graphical interface
--version Show version and exit

Building from source

# Install build tools
pip install hatchling

# Build package
python -m build

Development

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

# Run linter
ruff check app/

# Run formatter
ruff format app/

# Run type checker
mypy app/

# Run tests
pytest

Project structure

aitecommander/
├── app/
│   ├── core/           # Database, logging, settings, error handling
│   ├── controllers/    # Business logic, UI controllers, undo/redo
│   ├── models/         # Entities, managers, migrations, workers
│   ├── views/          # Windows, widgets, dialogs, tree/table models
│   ├── services/       # Theme, share, bulk operations, structure
│   ├── utils/          # Browser import, icons, drag & drop, validators
│   ├── resources/      # Themes (QSS), icons, logos
│   ├── startup/        # App initialization, argument parsing
│   └── config_data/    # Configuration payload and adapters
├── i18n/               # Translation files (.ts/.qm)
├── scripts/            # Utility scripts
├── tests/              # Test suite
└── pyproject.toml      # Project metadata and build config

License

MIT

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages