# far-se/tabame architecture

> Architecture diagram of the GitHub repository far-se/tabame, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/far-se/tabame
- Repository: https://github.com/far-se/tabame

## Overview

Tabame is a Windows-focused Flutter toolbox centered on a hotkey-invoked QuickMenu and keyboard-driven Launcher, with launcher plugins and many additional utilities. The tree provided contains native platform code and plugin implementations, but not the Flutter application sources; the README therefore supplies most feature-level relationships. Sampled native code shows QuickClick’s keyboard-hook and mouse-input behavior, while startup-manager behavior is visible without evidence of its caller.

Main entry points: [`plugins`](https://github.com/far-se/tabame/tree/main/plugins) (Launcher), [`plugins/echo/main.py`](https://github.com/far-se/tabame/blob/main/plugins/echo/main.py) (Plugin Protocol), [`windows/runner`](https://github.com/far-se/tabame/tree/main/windows/runner) (QuickMenu), [`tabamewin32/windows/quickClick/QuickClickController.cpp`](https://github.com/far-se/tabame/blob/main/tabamewin32/windows/quickClick/QuickClickController.cpp) (QuickClick)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Launcher and Controls"]
  node_quickmenu["QuickMenu"]
  node_launcher["Launcher"]
  node_quickclick["QuickClick"]
end

subgraph group_plugins["Launcher Plugins"]
  node_plugin_host["Plugin Protocol<br/>[main.py]"]
  node_plugin_catalog["Plugin Catalog"]
  node_api_client["API Client<br/>[main.py]"]
  node_rss["RSS and Read Later<br/>[main.py]"]
  node_audio_tags["Audio Tag Editor<br/>[main.py]"]
  node_video_downloads["Video Downloads<br/>[main.py]"]
  node_kanban["Kanban<br/>[main.py]"]
  node_pomodoro["Pomodoro<br/>[controller.py]"]
end

subgraph group_desktop["Windows Desktop"]
  node_windows_controls["Windows Controls"]
  node_startup["Startup Management"]
  node_quick_snap["QuickSnap"]
  node_hotkeys["Hotkeys"]
end

subgraph group_personal["Personal Tools"]
  node_vault_auth["Vault and Authenticator<br/>[main.py]"]
  node_tasks["Tasks and Reminders<br/>[main.py]"]
  node_activity["Activity Tracking"]
  node_file_tools["File Utilities"]
end

subgraph group_media["Media and Screen"]
  node_screen_tools["Screen Tools"]
  node_audio_music["Audio and Music<br/>[main.py]"]
end

node_user(("User"))

node_user -->|"opens by hotkey"| node_quickmenu
node_user -->|"searches with keyboard"| node_launcher
node_user -->|"controls by shortcut"| node_quickclick
node_launcher -->|"extends with plugins"| node_plugin_catalog
node_plugin_host -->|"implements plugin protocol"| node_plugin_catalog
node_user -->|"snaps windows"| node_quick_snap
node_user -->|"uses screen tools"| node_screen_tools
node_user -->|"uses audio controls"| node_audio_music
node_user -->|"uses vault and authenticator"| node_vault_auth
node_user -->|"manages reminders"| node_tasks
node_user -->|"tracks activity"| node_activity
node_user -->|"uses file tools"| node_file_tools

click node_quickmenu "https://github.com/far-se/tabame/tree/main/windows/runner"
click node_launcher "https://github.com/far-se/tabame/tree/main/plugins"
click node_quickclick "https://github.com/far-se/tabame/blob/main/tabamewin32/windows/quickClick/QuickClickController.cpp"
click node_plugin_host "https://github.com/far-se/tabame/blob/main/plugins/echo/main.py"
click node_plugin_catalog "https://github.com/far-se/tabame/tree/main/plugins"
click node_api_client "https://github.com/far-se/tabame/blob/main/plugins/api-client/main.py"
click node_rss "https://github.com/far-se/tabame/blob/main/plugins/rss/main.py"
click node_audio_tags "https://github.com/far-se/tabame/blob/main/plugins/audio-tag-transformer/main.py"
click node_video_downloads "https://github.com/far-se/tabame/blob/main/plugins/yt-dlp/main.py"
click node_kanban "https://github.com/far-se/tabame/blob/main/plugins/kanban/main.py"
click node_pomodoro "https://github.com/far-se/tabame/blob/main/plugins/pomodoro/controller.py"
click node_windows_controls "https://github.com/far-se/tabame/tree/main/tabamewin32/windows"
click node_startup "https://github.com/far-se/tabame/blob/main/windows/runner/startup_manager.cpp"
click node_quick_snap "https://github.com/far-se/tabame/tree/main/tabamewin32/windows"
click node_hotkeys "https://github.com/far-se/tabame/tree/main/tabamewin32/windows"
click node_screen_tools "https://github.com/far-se/tabame/tree/main/tabamewin32/windows"
click node_audio_music "https://github.com/far-se/tabame/blob/main/plugins/spotify/main.py"
click node_vault_auth "https://github.com/far-se/tabame/blob/main/plugins/bitwarden/main.py"
click node_tasks "https://github.com/far-se/tabame/blob/main/plugins/reminder/main.py"
click node_activity "https://github.com/far-se/tabame/tree/main/plugins"
click node_file_tools "https://github.com/far-se/tabame/tree/main/plugins"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_quickmenu,node_launcher,node_quickclick,node_user toneBlue
class node_plugin_host,node_plugin_catalog,node_api_client,node_rss,node_audio_tags,node_video_downloads,node_kanban,node_pomodoro toneAmber
class node_windows_controls,node_startup,node_quick_snap,node_hotkeys toneMint
class node_vault_auth,node_tasks,node_activity,node_file_tools toneRose
class node_screen_tools,node_audio_music toneIndigo
```

## Components

### Launcher and Controls

- [QuickMenu](https://github.com/far-se/tabame/tree/main/windows/runner): `windows/runner`
- [Launcher](https://github.com/far-se/tabame/tree/main/plugins): `plugins`
- [QuickClick](https://github.com/far-se/tabame/blob/main/tabamewin32/windows/quickClick/QuickClickController.cpp): `tabamewin32/windows/quickClick/QuickClickController.cpp`

### Launcher Plugins

- [Plugin Protocol](https://github.com/far-se/tabame/blob/main/plugins/echo/main.py): `plugins/echo/main.py`
- [Plugin Catalog](https://github.com/far-se/tabame/tree/main/plugins): `plugins`
- [API Client](https://github.com/far-se/tabame/blob/main/plugins/api-client/main.py): `plugins/api-client/main.py`
- [RSS and Read Later](https://github.com/far-se/tabame/blob/main/plugins/rss/main.py): `plugins/rss/main.py`
- [Audio Tag Editor](https://github.com/far-se/tabame/blob/main/plugins/audio-tag-transformer/main.py): `plugins/audio-tag-transformer/main.py`
- [Video Downloads](https://github.com/far-se/tabame/blob/main/plugins/yt-dlp/main.py): `plugins/yt-dlp/main.py`
- [Kanban](https://github.com/far-se/tabame/blob/main/plugins/kanban/main.py): `plugins/kanban/main.py`
- [Pomodoro](https://github.com/far-se/tabame/blob/main/plugins/pomodoro/controller.py): `plugins/pomodoro/controller.py`

### Windows Desktop

- [Windows Controls](https://github.com/far-se/tabame/tree/main/tabamewin32/windows): `tabamewin32/windows`
- [Startup Management](https://github.com/far-se/tabame/blob/main/windows/runner/startup_manager.cpp): `windows/runner/startup_manager.cpp`
- [QuickSnap](https://github.com/far-se/tabame/tree/main/tabamewin32/windows): `tabamewin32/windows`
- [Hotkeys](https://github.com/far-se/tabame/tree/main/tabamewin32/windows): `tabamewin32/windows`

### Personal Tools

- [Vault and Authenticator](https://github.com/far-se/tabame/blob/main/plugins/bitwarden/main.py): `plugins/bitwarden/main.py`
- [Tasks and Reminders](https://github.com/far-se/tabame/blob/main/plugins/reminder/main.py): `plugins/reminder/main.py`
- [Activity Tracking](https://github.com/far-se/tabame/tree/main/plugins): `plugins`
- [File Utilities](https://github.com/far-se/tabame/tree/main/plugins): `plugins`

### Media and Screen

- [Screen Tools](https://github.com/far-se/tabame/tree/main/tabamewin32/windows): `tabamewin32/windows`
- [Audio and Music](https://github.com/far-se/tabame/blob/main/plugins/spotify/main.py): `plugins/spotify/main.py`

### Other components

- **User**

## Connections

- User → QuickMenu: opens by hotkey (evidence: `README.md`)
- User → Launcher: searches with keyboard (evidence: `README.md`)
- User → QuickClick: controls by shortcut (evidence: `README.md`)
- Launcher → Plugin Catalog: extends with plugins (evidence: `README.md`)
- Plugin Protocol → Plugin Catalog: implements plugin protocol (evidence: `plugins/echo/main.py`)
- User → QuickSnap: snaps windows (evidence: `README.md`)
- User → Screen Tools: uses screen tools (evidence: `README.md`)
- User → Audio and Music: uses audio controls (evidence: `README.md`)
- User → Vault and Authenticator: uses vault and authenticator (evidence: `README.md`)
- User → Tasks and Reminders: manages reminders (evidence: `README.md`)
- User → Activity Tracking: tracks activity (evidence: `README.md`)
- User → File Utilities: uses file tools (evidence: `README.md`)
