# barypia/barymusic architecture

> Architecture diagram of the GitHub repository barypia/barymusic, 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/barypia/barymusic
- Repository: https://github.com/barypia/barymusic

## Overview

BaryMusic is a web app for managing a song library and setlists, then presenting lyrics and display settings to connected screens through channels. Users work in the browser; its frontend covers song editing, setlist organization, channel control, and output display, while a Node.js service provides HTTP/WebSocket behavior and SQLite-backed multi-user data. The graph preserves documented import, sheet-music, search, and access-control capabilities. Some frontend wiring and server route details were not sampled, so uncertain links are omitted or marked dashed.

Main entry points: [`server/barymusic.js`](https://github.com/barypia/barymusic/blob/main/server/barymusic.js) (HTTP and channels), [`frontend/js/song/song.js`](https://github.com/barypia/barymusic/blob/main/frontend/js/song/song.js) (Song library), [`frontend/js/core/settings.js`](https://github.com/barypia/barymusic/blob/main/frontend/js/core/settings.js) (Display settings), [`frontend/js/ws/websocket.js`](https://github.com/barypia/barymusic/blob/main/frontend/js/ws/websocket.js) (Channel connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser interface"]
  node_init["App initialization<br/>[init.js]"]
  node_navigation["Navigation<br/>[navigation.js]"]
  node_settings["Display settings<br/>[settings.js]"]
  node_settings_store["Settings storage<br/>[settings-store.js]"]
  node_i18n["Localization<br/>[i18n.js]"]
end

subgraph group_content["Song content"]
  node_song_library["Song library<br/>[song.js]"]
  node_song_search["Song search<br/>[songs-fetch.js]"]
  node_lyrics["Lyrics and chords<br/>[lyrics.js]"]
  node_song_metadata["Song metadata<br/>[song-metadata.js]"]
  node_sheet_music["Sheet music<br/>[sheets.js]"]
  node_musicxml["MusicXML import<br/>[musicxml-parser.js]"]
  node_song_import["Song import<br/>[add-song.js]"]
  node_setlist_editor["Setlist editor<br/>[setlist-editor.js]"]
  node_setlists["Setlist management<br/>[setlists.js]"]
end

subgraph group_live["Live presentation"]
  node_channel_client["Channel connection<br/>[websocket.js]"]
  node_output["Lyrics output<br/>[output.js]"]
  node_audio["Song audio<br/>[audio.js]"]
end

subgraph group_backend["Service and data"]
  node_auth["Accounts and access<br/>[auth.js]"]
  node_server["HTTP and channels<br/>[barymusic.js]"]
  node_database[("SQLite data<br/>[barymusic.js]")]
  node_transfer["Library transfer<br/>[transfer.js]"]
end

node_user(("Presenter or editor"))
node_external_screen(("External screen"))

node_user -->|"uses"| node_init
node_init -.->|"manage songs"| node_song_library
node_song_library -->|"searches"| node_song_search
node_song_library -->|"edits lyrics"| node_lyrics
node_song_library -->|"attaches sheets"| node_sheet_music
node_song_import -.->|"imports MusicXML"| node_musicxml
node_server -->|"uses"| node_song_metadata
node_song_library -.->|"uses metadata"| node_song_metadata
node_user -->|"organizes"| node_setlist_editor
node_setlist_editor -.->|"manages items"| node_setlists
node_auth -->|"requests auth"| node_server
node_server -->|"reads and writes"| node_database
node_transfer -.->|"transfers library"| node_server
node_user -->|"connects"| node_channel_client
node_channel_client -.->|"exchanges channel data"| node_server
node_server -.->|"sends live lyrics"| node_output
node_output -->|"displays lyrics"| node_external_screen
node_user -->|"configures display"| node_settings
node_settings -.->|"persists settings"| node_settings_store
node_settings -->|"syncs settings"| node_channel_client
node_user -.->|"plays song audio"| node_audio
node_user -->|"chooses language"| node_i18n

click node_init "https://github.com/barypia/barymusic/blob/main/frontend/js/core/init.js"
click node_navigation "https://github.com/barypia/barymusic/blob/main/frontend/js/core/navigation.js"
click node_settings "https://github.com/barypia/barymusic/blob/main/frontend/js/core/settings.js"
click node_settings_store "https://github.com/barypia/barymusic/blob/main/frontend/js/core/settings-store.js"
click node_i18n "https://github.com/barypia/barymusic/blob/main/frontend/js/core/i18n.js"
click node_song_library "https://github.com/barypia/barymusic/blob/main/frontend/js/song/song.js"
click node_song_search "https://github.com/barypia/barymusic/blob/main/frontend/js/core/songs-fetch.js"
click node_lyrics "https://github.com/barypia/barymusic/blob/main/frontend/js/song/lyrics.js"
click node_song_metadata "https://github.com/barypia/barymusic/blob/main/server/song-metadata.js"
click node_sheet_music "https://github.com/barypia/barymusic/blob/main/frontend/js/song/sheets.js"
click node_musicxml "https://github.com/barypia/barymusic/blob/main/frontend/js/rest/musicxml-parser.js"
click node_song_import "https://github.com/barypia/barymusic/blob/main/frontend/js/rest/add-song.js"
click node_setlist_editor "https://github.com/barypia/barymusic/blob/main/frontend/js/setlist/setlist-editor.js"
click node_setlists "https://github.com/barypia/barymusic/blob/main/frontend/js/setlist/setlists.js"
click node_auth "https://github.com/barypia/barymusic/blob/main/frontend/js/rest/auth.js"
click node_server "https://github.com/barypia/barymusic/blob/main/server/barymusic.js"
click node_database "https://github.com/barypia/barymusic/blob/main/server/barymusic.js"
click node_transfer "https://github.com/barypia/barymusic/blob/main/frontend/js/rest/transfer.js"
click node_channel_client "https://github.com/barypia/barymusic/blob/main/frontend/js/ws/websocket.js"
click node_output "https://github.com/barypia/barymusic/blob/main/frontend/js/output/output.js"
click node_audio "https://github.com/barypia/barymusic/blob/main/frontend/js/song/audio.js"

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_init,node_navigation,node_settings,node_settings_store,node_i18n,node_external_screen toneBlue
class node_song_library,node_song_search,node_lyrics,node_song_metadata,node_sheet_music,node_musicxml,node_song_import,node_setlist_editor,node_setlists toneAmber
class node_channel_client,node_output,node_audio toneMint
class node_auth,node_server,node_database,node_transfer toneRose
class node_user toneIndigo
```

## Components

### Browser interface

- [App initialization](https://github.com/barypia/barymusic/blob/main/frontend/js/core/init.js): `frontend/js/core/init.js`
- [Navigation](https://github.com/barypia/barymusic/blob/main/frontend/js/core/navigation.js): `frontend/js/core/navigation.js`
- [Display settings](https://github.com/barypia/barymusic/blob/main/frontend/js/core/settings.js): `frontend/js/core/settings.js`
- [Settings storage](https://github.com/barypia/barymusic/blob/main/frontend/js/core/settings-store.js): `frontend/js/core/settings-store.js`
- [Localization](https://github.com/barypia/barymusic/blob/main/frontend/js/core/i18n.js): `frontend/js/core/i18n.js`

### Song content

- [Song library](https://github.com/barypia/barymusic/blob/main/frontend/js/song/song.js): `frontend/js/song/song.js`
- [Song search](https://github.com/barypia/barymusic/blob/main/frontend/js/core/songs-fetch.js): `frontend/js/core/songs-fetch.js`
- [Lyrics and chords](https://github.com/barypia/barymusic/blob/main/frontend/js/song/lyrics.js): `frontend/js/song/lyrics.js`
- [Song metadata](https://github.com/barypia/barymusic/blob/main/server/song-metadata.js): `server/song-metadata.js`
- [Sheet music](https://github.com/barypia/barymusic/blob/main/frontend/js/song/sheets.js): `frontend/js/song/sheets.js`
- [MusicXML import](https://github.com/barypia/barymusic/blob/main/frontend/js/rest/musicxml-parser.js): `frontend/js/rest/musicxml-parser.js`
- [Song import](https://github.com/barypia/barymusic/blob/main/frontend/js/rest/add-song.js): `frontend/js/rest/add-song.js`
- [Setlist editor](https://github.com/barypia/barymusic/blob/main/frontend/js/setlist/setlist-editor.js): `frontend/js/setlist/setlist-editor.js`
- [Setlist management](https://github.com/barypia/barymusic/blob/main/frontend/js/setlist/setlists.js): `frontend/js/setlist/setlists.js`

### Live presentation

- [Channel connection](https://github.com/barypia/barymusic/blob/main/frontend/js/ws/websocket.js): `frontend/js/ws/websocket.js`
- [Lyrics output](https://github.com/barypia/barymusic/blob/main/frontend/js/output/output.js): `frontend/js/output/output.js`
- [Song audio](https://github.com/barypia/barymusic/blob/main/frontend/js/song/audio.js): `frontend/js/song/audio.js`

### Service and data

- [Accounts and access](https://github.com/barypia/barymusic/blob/main/frontend/js/rest/auth.js): `frontend/js/rest/auth.js`
- [HTTP and channels](https://github.com/barypia/barymusic/blob/main/server/barymusic.js): `server/barymusic.js`
- [SQLite data](https://github.com/barypia/barymusic/blob/main/server/barymusic.js): `server/barymusic.js`
- [Library transfer](https://github.com/barypia/barymusic/blob/main/frontend/js/rest/transfer.js): `frontend/js/rest/transfer.js`

### Other components

- **Presenter or editor**
- **External screen**

## Connections

- Presenter or editor → App initialization: uses (evidence: `README.md`)
- App initialization → Song library: manage songs
- Song library → Song search: searches (evidence: `README.md`)
- Song library → Lyrics and chords: edits lyrics (evidence: `README.md`)
- Song library → Sheet music: attaches sheets (evidence: `README.md`)
- Song import → MusicXML import: imports MusicXML
- HTTP and channels → Song metadata: uses (evidence: `server/barymusic.js`)
- Song library → Song metadata: uses metadata
- Presenter or editor → Setlist editor: organizes (evidence: `README.md`)
- Setlist editor → Setlist management: manages items
- Accounts and access → HTTP and channels: requests auth (evidence: `frontend/js/rest/auth.js`)
- HTTP and channels → SQLite data: reads and writes (evidence: `server/barymusic.js`)
- Library transfer → HTTP and channels: transfers library
- Presenter or editor → Channel connection: connects (evidence: `README.md`)
- Channel connection → HTTP and channels: exchanges channel data
- HTTP and channels → Lyrics output: sends live lyrics
- Lyrics output → External screen: displays lyrics (evidence: `README.md`)
- Presenter or editor → Display settings: configures display (evidence: `README.md`)
- Display settings → Settings storage: persists settings
- Display settings → Channel connection: syncs settings (evidence: `README.md`)
- Presenter or editor → Song audio: plays song audio
- Presenter or editor → Localization: chooses language (evidence: `README.md`)
