# hosammandor45-eng/nixesty-now-bar architecture

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

- Interactive diagram: https://gitdiagram.com/hosammandor45-eng/nixesty-now-bar
- Repository: https://github.com/hosammandor45-eng/nixesty-now-bar

## Overview

Now Bar is a Windows taskbar activity bar: the app gathers current activities, prioritizes them, and presents the front activity as an animated pill with an expandable card. Its capabilities span media, timers, sports, weather, Claude Code, games, system status, file handling, and third-party live activities. The README documents several integrations and user flows; source excerpts show app orchestration and rendering, but not every activity’s wiring, so some documented links are cited to the README and uncertain implementation paths are omitted.

Main entry points: [`src/app.rs`](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/app.rs) (Activity coordinator), [`src/activities/media.rs`](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/media.rs) (Media sessions), [`src/activities/weather.rs`](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/weather.rs) (Weather activity), [`src/activities/shelf.rs`](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/shelf.rs) (File shelf)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_app["Activity coordinator<br/>[app.rs]"]
end

subgraph group_activities["Activity domains"]
  node_activity_stack["Activity ordering<br/>[mod.rs]"]
  node_media["Media sessions<br/>[media.rs]"]
  node_media_worker["Media watcher<br/>[media_worker.rs]"]
  node_lyrics["Synchronized lyrics<br/>[lyrics.rs]"]
  node_sports["Live sports<br/>[football.rs]"]
  node_games["Game activity<br/>[games.rs]"]
  node_weather["Weather activity<br/>[weather.rs]"]
  node_weather_alert["Weather alerts<br/>[weather_alert.rs]"]
  node_claude["Claude Code activity<br/>[claude.rs]"]
  node_live["External live events<br/>[live.rs]"]
  node_api["App notification API<br/>[api.rs]"]
  node_buds["Galaxy Buds status<br/>[buds.rs]"]
  node_shelf["File shelf<br/>[shelf.rs]"]
  node_shelf_tools["Shelf actions"]
end

subgraph group_presentation["Taskbar presentation"]
  node_pill["Taskbar pill<br/>[pill.rs]"]
  node_card["Activity cards<br/>[card.rs]"]
end

subgraph group_platform["Windows platform"]
  node_windows["Windows integration<br/>[windows.rs]"]
  node_api_server["Local API server<br/>[api_server.rs]"]
end

subgraph group_config["Configuration"]
  node_settings[("User settings<br/>[settings.rs]")]
  node_settings_ui["Settings window<br/>[settings_ui.rs]"]
end

node_user(("Windows user"))
node_steam{{"Steam and Epic"}}
node_espn{{"ESPN sports data"}}
node_lrclib{{"LRCLIB lyrics"}}
node_claude_cli{{"Claude Code"}}

node_user -->|"uses"| node_app
node_app -->|"orders activities"| node_activity_stack
node_app -->|"coordinates"| node_media
node_app -->|"coordinates"| node_sports
node_app -->|"coordinates"| node_games
node_app -->|"coordinates"| node_weather
node_app -->|"coordinates"| node_claude
node_app -->|"coordinates"| node_live
node_app -->|"coordinates"| node_buds
node_app -->|"coordinates"| node_shelf
node_media_worker -->|"posts snapshots"| node_media
node_user -.->|"plays media"| node_media
node_media -.->|"shows lyrics"| node_lyrics
node_lyrics -->|"fetches lyrics"| node_lrclib
node_sports -->|"fetches match data"| node_espn
node_games -->|"reads game state"| node_steam
node_user -.->|"views forecast"| node_weather
node_weather -->|"raises alerts"| node_weather_alert
node_claude_cli -.->|"sends hooks"| node_claude
node_user -.->|"submits events"| node_api
node_api_server -.->|"receives API events"| node_api
node_user -->|"drops files"| node_shelf
node_shelf_tools -->|"processes selected files"| node_shelf
node_app -->|"updates display"| node_pill
node_app -->|"opens activity cards"| node_card
node_pill -->|"opens card"| node_card
node_settings_ui -->|"saves preferences"| node_settings
node_settings -->|"configures activity"| node_app
node_app -.->|"uses OS services"| node_windows
node_user -->|"configures"| node_settings_ui
node_user -.->|"checks Buds"| node_buds
node_user -->|"views events"| node_live

click node_app "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/app.rs"
click node_activity_stack "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/mod.rs"
click node_media "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/media.rs"
click node_media_worker "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/media_worker.rs"
click node_lyrics "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/lyrics.rs"
click node_sports "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/football.rs"
click node_games "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/games.rs"
click node_weather "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/weather.rs"
click node_weather_alert "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/weather_alert.rs"
click node_claude "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/claude.rs"
click node_live "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/live.rs"
click node_api "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/api.rs"
click node_buds "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/buds.rs"
click node_shelf "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/shelf.rs"
click node_shelf_tools "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/shelf_tools_worker.rs"
click node_pill "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/render/pill.rs"
click node_card "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/render/card.rs"
click node_settings "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/settings.rs"
click node_settings_ui "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/settings_ui.rs"
click node_windows "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/platform/windows.rs"
click node_api_server "https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/platform/api_server.rs"

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_app,node_user toneBlue
class node_activity_stack,node_media,node_media_worker,node_lyrics,node_sports,node_games,node_weather,node_weather_alert,node_claude,node_live,node_api,node_buds,node_shelf,node_shelf_tools toneAmber
class node_pill,node_card toneMint
class node_windows,node_api_server toneRose
class node_settings,node_settings_ui,node_steam,node_espn,node_lrclib,node_claude_cli toneIndigo
```

## Components

### Application runtime

- [Activity coordinator](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/app.rs): `src/app.rs`

### Activity domains

- [Activity ordering](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/mod.rs): `src/activities/mod.rs`
- [Media sessions](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/media.rs): `src/activities/media.rs`
- [Media watcher](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/media_worker.rs): `src/activities/media_worker.rs`
- [Synchronized lyrics](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/lyrics.rs): `src/activities/lyrics.rs`
- [Live sports](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/football.rs): `src/activities/football.rs`
- [Game activity](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/games.rs): `src/activities/games.rs`
- [Weather activity](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/weather.rs): `src/activities/weather.rs`
- [Weather alerts](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/weather_alert.rs): `src/activities/weather_alert.rs`
- [Claude Code activity](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/claude.rs): `src/activities/claude.rs`
- [External live events](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/live.rs): `src/activities/live.rs`
- [App notification API](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/api.rs): `src/activities/api.rs`
- [Galaxy Buds status](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/buds.rs): `src/activities/buds.rs`
- [File shelf](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/shelf.rs): `src/activities/shelf.rs`
- [Shelf actions](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/activities/shelf_tools_worker.rs): `src/activities/shelf_tools_worker.rs`

### Taskbar presentation

- [Taskbar pill](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/render/pill.rs): `src/render/pill.rs`
- [Activity cards](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/render/card.rs): `src/render/card.rs`

### Windows platform

- [Windows integration](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/platform/windows.rs): `src/platform/windows.rs`
- [Local API server](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/platform/api_server.rs): `src/platform/api_server.rs`

### Configuration

- [User settings](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/settings.rs): `src/settings.rs`
- [Settings window](https://github.com/hosammandor45-eng/nixesty-now-bar/blob/main/src/settings_ui.rs): `src/settings_ui.rs`

### Other components

- **Windows user**
- **Steam and Epic**
- **ESPN sports data**
- **LRCLIB lyrics**
- **Claude Code**

## Connections

- Windows user → Activity coordinator: uses (evidence: `README.md`)
- Activity coordinator → Activity ordering: orders activities (evidence: `src/activities/mod.rs`)
- Activity coordinator → Media sessions: coordinates (evidence: `src/app.rs`)
- Activity coordinator → Live sports: coordinates (evidence: `src/app.rs`)
- Activity coordinator → Game activity: coordinates (evidence: `src/app.rs`)
- Activity coordinator → Weather activity: coordinates (evidence: `src/app.rs`)
- Activity coordinator → Claude Code activity: coordinates (evidence: `src/app.rs`)
- Activity coordinator → External live events: coordinates (evidence: `src/app.rs`)
- Activity coordinator → Galaxy Buds status: coordinates (evidence: `src/app.rs`)
- Activity coordinator → File shelf: coordinates (evidence: `src/app.rs`)
- Media watcher → Media sessions: posts snapshots (evidence: `src/activities/media_worker.rs`)
- Windows user → Media sessions: plays media (evidence: `README.md`)
- Media sessions → Synchronized lyrics: shows lyrics (evidence: `README.md`)
- Synchronized lyrics → LRCLIB lyrics: fetches lyrics (evidence: `README.md`)
- Live sports → ESPN sports data: fetches match data (evidence: `src/activities/football.rs`)
- Game activity → Steam and Epic: reads game state (evidence: `src/activities/games.rs`)
- Windows user → Weather activity: views forecast (evidence: `README.md`)
- Weather activity → Weather alerts: raises alerts (evidence: `src/activities/weather_alert.rs`)
- Claude Code → Claude Code activity: sends hooks (evidence: `README.md`)
- Windows user → App notification API: submits events (evidence: `README.md`)
- Local API server → App notification API: receives API events
- Windows user → File shelf: drops files (evidence: `README.md`)
- Shelf actions → File shelf: processes selected files (evidence: `src/activities/shelf_tools_worker.rs`)
- Activity coordinator → Taskbar pill: updates display (evidence: `src/app.rs`)
- Activity coordinator → Activity cards: opens activity cards (evidence: `src/app.rs`)
- Taskbar pill → Activity cards: opens card (evidence: `src/render/pill.rs`)
- Settings window → User settings: saves preferences (evidence: `src/settings.rs`)
- User settings → Activity coordinator: configures activity (evidence: `src/settings.rs`)
- Activity coordinator → Windows integration: uses OS services
- Windows user → Settings window: configures (evidence: `README.md`)
- Windows user → Galaxy Buds status: checks Buds (evidence: `README.md`)
- Windows user → External live events: views events (evidence: `README.md`)
