# narmis-e/onedark-wallpapers architecture

> Architecture diagram of the GitHub repository narmis-e/onedark-wallpapers, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/narmis-e/onedark-wallpapers
- Repository: https://github.com/narmis-e/onedark-wallpapers

## Overview

##### What this project is (type + purpose)
This repo is **not an application/service**—it’s a **curated asset collection** (wallpapers) organized into themed directories, with a README describing the **visual design goal**: wallpapers colorized to match the **OneDark** palette (referencing `onedark.vim`, Atom One Dark greys, and workflows like ImageGoNord; future: `tint`).

##### What the file tree implies about structure
Top-level directories are essentially **categories/collections**:

- `minimal/` (and `minimal/torvalds/`): minimal-style wallpapers and a sub-collection
- `os/`: OS-themed wallpapers
- `wm/`: window-manager-themed wallpapers
- `programs/`: app/program-themed wallpapers
- `botw/`: likely a themed set (e.g., Breath of the Wild)
- `misc/`: catch-all / uncategorized
- `showcase.md`: gallery/preview document (noted as “Todo: fix showcase gallery”)
- `LICENSE`, `README.md`: repo metadata/documentation

There’s no `src/`, no build scripts, no CI config visible, no code. The “architecture” is primarily:

##### What the README adds (key architectural facts)

- **Palette specification**:
- OneDark palette from `joshdick/onedark.vim`
- Additional greys from Atom One Dark 2
- **Processing tools**:
- Current: ImageGoNord (IGN)
- Future replacement: `tint` (explicit TODO)
- Manual touch-up sometimes implied (e.g., “touch it up by making the bg blue again” and GIMP hex mismatch TODO)
- **Sources**:
- Reddit, unixporn Discord, Wayback archives of other collections, Nordic repo, Imgur dumps
- **Constraints**:
- Images are ≥ 1920×1080, some up to 5K
- **Community workflow**:
- Contributions & requests via issues/PRs
- Removal requests process

##### External Sources
- Reddit / Discord / Wayback archives / other wallpaper repos / Imgur dumps

##### Acquisition / Curation
- Human curator (repo maintainer)
- Optional: “selection criteria” (resolution threshold, theme fit)

##### Processing Pipeline
- Automated colorization tool: ImageGoNord (current)
- Planned tool: tint (future)
- Manual editing tool: GIMP (implied by TODO)
- Output: OneDark-colorized images (final assets)

##### Repository Organization (Artifact Store)
- Folder taxonomy: `minimal/`, `os/`, `wm/`, `programs/`, `botw/`, `misc/`
- Special subcollection: `minimal/torvalds/`

##### Contribution & Governance
- GitHub Issues (requests, removal requests)
- Pull Requests (contributions)
- Licensing (`LICENSE`)

- External Sources → Acquisition/Selection
- Acquisition/Selection → Processing Pipeline
- Processing Pipeline → Manual Touch-up (optional branch)
- Processing Pipeline / Manual Touch-up → Repository Organization (commit assets)
- Repository Organization → Documentation/Showcase (gallery consumes folder assets)
- Contributors → PRs → Repository Organization
- Users/Creators → Removal Requests (Issues) → Maintainer → Repository changes

##### Architectural patterns/design principles present
Even without code, there are clear patterns:

- **Asset pipeline** pattern: ingest → transform → publish
- **Taxonomy-first organization**: folders represent “domains” (minimal/os/wm/programs/etc.)
- **Human-in-the-loop processing**: automated filter + manual corrections
- **Community-driven inputs**: issues/PRs govern changes

##### Relevant technologies/tools prominently
These matter more than “frameworks” here:

- ImageGoNord (current transformation)
- tint (planned replacement)
- GIMP (manual adjustment)
- GitHub (repo hosting + issues/PR workflow)
- OneDark palette sources (onedark.vim; Atom greys)

##### External Sources (clouds)
- Reddit, Discord, Wayback archives, Nordic repo, Imgur dumps
##### Curation (process)
- select, verify resolution, pick theme/category
##### Colorization (process)
- ImageGoNord (current)
- (future) tint
##### Manual QA/Touch-up (optional process)
- GIMP adjustments (noted hex mismatch issue)
##### Publish (artifact store)
- commit into `minimal/`, `os/`, `wm/`, `programs/`, `botw/`, `misc/`
##### Community Loop (governance)
- contributors via PRs
- requests/removals via Issues

- root
- botw/
- minimal/
- torvalds/
- misc/
- os/
- programs/
- wm/
- README.md
- .md
- LICENSE

Folder node with the “theme intent” (minimal, OS-specific, WM-themed, etc.).

##### “Separate into as many components as possible” (without overthinking)
For maximum detail (useful at principal level), explicitly split:
- “Palette spec” vs “Tool implementing palette mapping”
- “Automated transform” vs “Manual correction”
- “Storage taxonomy” vs “Gallery rendering” (even if it’s just markdown)
- “Contribution workflow” vs “Removal workflow”

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Diagram 1: Content Pipeline / Lifecycle (Vertical)
  %% =========================
  subgraph D1["Diagram 1 — OneDark Wallpaper Lifecycle (Content Pipeline)"]
    direction TB

    subgraph EXT["External Sources (Ingestion Inputs)"]
      direction TB
      SRC_R["Reddit (wallpapers/posts)"]:::external
      SRC_D["unixporn Discord (shares/links)"]:::external
      SRC_W["Wayback archives (older collections)"]:::external
      SRC_N["Other wallpaper repos (e.g., Nordic repo)"]:::external
      SRC_I["Imgur dumps (albums/collections)"]:::external
    end

    subgraph CUR["Acquisition & Curation (Human-in-the-loop)"]
      direction TB
      CURATOR["Maintainer / Curator"]:::process
      CRIT["Selection criteria:\n- Theme fit\n- Resolution ≥ 1920×1080\n- Some up to 5K"]:::note
    end

    subgraph SPEC["Color Reference System (Palette Specs)"]
      direction TB
      PAL_OD["OneDark palette reference\n(joshdick/onedark.vim)"]:::spec
      PAL_G["Atom One Dark 2 greys\n(additional greys)"]:::spec
    end

    subgraph PIPE["Processing Pipeline (Transform)"]
      direction TB
      IGN["ImageGoNord (current colorization tool)"]:::tool
      TINT["tint (planned replacement / TODO)"]:::toolFuture
      OUT["OneDark-colorized wallpapers\n(final assets)"]:::artifact
    end

    subgraph QA["Manual QA / Touch-up (Optional)"]
      direction TB
      GIMP["GIMP (manual adjustments)\n(hex mismatch/touch-up TODO)"]:::manual
    end

    subgraph STORE["Repository Organization (Artifact Store)"]
      direction TB
      TAX["Folder taxonomy (themed collections)"]:::store
      F_MIN["minimal/"]:::folder
      F_TOR["minimal/torvalds/"]:::folder
      F_OS["os/"]:::folder
      F_WM["wm/"]:::folder
      F_PROG["programs/"]:::folder
      F_BOTW["botw/"]:::folder
      F_MISC["misc/"]:::folder
    end

    subgraph DOCS["Documentation / Presentation"]
      direction TB
      README["README.md\n(purpose, palette refs, rules)"]:::doc
      SHOW["showcase.md\n(gallery/preview; TODO fix)"]:::doc
      LIC["LICENSE"]:::docMeta
    end

    subgraph GOV["Contribution & Governance (GitHub Workflow)"]
      direction TB
      USERS["Users / Contributors"]:::actor
      PR["Pull Requests\n(contribute wallpapers/organization)"]:::govern
      ISS["Issues\n(requests/removals)"]:::govern
      RM["Removal request process\n(request → maintainer action)"]:::govern
    end

    %% Main flows
    SRC_R -->|"submit_links"| CURATOR
    SRC_D -->|"share_links"| CURATOR
    SRC_W -->|"recover_sources"| CURATOR
    SRC_N -->|"borrow_inspiration"| CURATOR
    SRC_I -->|"collect_sets"| CURATOR

    CURATOR -->|"apply_criteria"| CRIT
    CRIT -->|"selected_assets"| IGN

    PAL_OD -->|"palette_spec"| IGN
    PAL_G -->|"grey_spec"| IGN

    IGN -->|"colorized_output"| OUT
    TINT -.->|"future_tool_swap"| IGN

    OUT -->|"optional_touchup"| GIMP
    GIMP -.->|"correct_colors"| OUT

    OUT -->|"commit_assets"| TAX
    TAX -->|"categorize"| F_MIN
    F_MIN -->|"subcollection"| F_TOR
    TAX -->|"categorize"| F_OS
    TAX -->|"categorize"| F_WM
    TAX -->|"categorize"| F_PROG
    TAX -->|"categorize"| F_BOTW
    TAX -->|"categorize"| F_MISC

    %% Docs consume assets
    TAX -->|"refer_to_assets"| README
    TAX -->|"render_gallery"| SHOW
    LIC -->|"usage_terms"| README

    %% Community loop
    USERS -->|"open_pr"| PR
    USERS -->|"open_issue"| ISS
    ISS -->|"removal_or_request"| RM
    RM -->|"maintainer_updates_repo"| TAX
    PR -->|"merge_changes"| TAX
    PR -->|"update_docs"| README
    PR -->|"update_gallery"| SHOW
  end

  %% =========================
  %% Diagram 2: Repository Taxonomy (Folder Map)
  %% =========================
  subgraph D2["Diagram 2 — Repository Taxonomy (Folder Map)"]
    direction TB

    ROOT["Repository Root"]:::root

    subgraph FOLDERS["Themed Collections (Directories)"]
      direction TB
      T_BOTW["botw/\n(themed set)"]:::folder
      T_MIN["minimal/\n(minimal-style wallpapers)"]:::folder
      T_TOR["minimal/torvalds/\n(sub-collection)"]:::folder
      T_MISC["misc/\n(catch-all/uncategorized)"]:::folder
      T_OS["os/\n(OS-themed wallpapers)"]:::folder
      T_PROG["programs/\n(app/program-themed)"]:::folder
      T_WM["wm/\n(window-manager-themed)"]:::folder
    end

    subgraph FILES["Docs & Metadata (Files)"]
      direction TB
      T_README["README.md\n(purpose + palette + contribution rules)"]:::doc
      T_SHOW["showcase.md\n(gallery/preview)"]:::doc
      T_LIC["LICENSE\n(licensing/governance metadata)"]:::docMeta
    end

    ROOT -->|"contains"| T_BOTW
    ROOT -->|"contains"| T_MIN
    T_MIN -->|"contains"| T_TOR
    ROOT -->|"contains"| T_MISC
    ROOT -->|"contains"| T_OS
    ROOT -->|"contains"| T_PROG
    ROOT -->|"contains"| T_WM

    ROOT -->|"contains"| T_README
    ROOT -->|"contains"| T_SHOW
    ROOT -->|"contains"| T_LIC
  end

  %% =========================
  %% Click Events (from component_mapping)
  %% =========================
  click F_BOTW "https://github.com/narmis-e/onedark-wallpapers/tree/main/botw/"
  click F_MIN "https://github.com/narmis-e/onedark-wallpapers/tree/main/minimal/"
  click F_TOR "https://github.com/narmis-e/onedark-wallpapers/tree/main/minimal/torvalds/"
  click F_MISC "https://github.com/narmis-e/onedark-wallpapers/tree/main/misc/"
  click F_OS "https://github.com/narmis-e/onedark-wallpapers/tree/main/os/"
  click F_PROG "https://github.com/narmis-e/onedark-wallpapers/tree/main/programs/"
  click F_WM "https://github.com/narmis-e/onedark-wallpapers/tree/main/wm/"
  click README "https://github.com/narmis-e/onedark-wallpapers/blob/main/README.md"
  click SHOW "https://github.com/narmis-e/onedark-wallpapers/blob/main/showcase.md"
  click LIC "https://github.com/narmis-e/onedark-wallpapers/tree/main/LICENSE"

  click T_BOTW "https://github.com/narmis-e/onedark-wallpapers/tree/main/botw/"
  click T_MIN "https://github.com/narmis-e/onedark-wallpapers/tree/main/minimal/"
  click T_TOR "https://github.com/narmis-e/onedark-wallpapers/tree/main/minimal/torvalds/"
  click T_MISC "https://github.com/narmis-e/onedark-wallpapers/tree/main/misc/"
  click T_OS "https://github.com/narmis-e/onedark-wallpapers/tree/main/os/"
  click T_PROG "https://github.com/narmis-e/onedark-wallpapers/tree/main/programs/"
  click T_WM "https://github.com/narmis-e/onedark-wallpapers/tree/main/wm/"
  click T_README "https://github.com/narmis-e/onedark-wallpapers/blob/main/README.md"
  click T_SHOW "https://github.com/narmis-e/onedark-wallpapers/blob/main/showcase.md"
  click T_LIC "https://github.com/narmis-e/onedark-wallpapers/tree/main/LICENSE"

  %% =========================
  %% Styles (color is critical)
  %% =========================
  classDef external fill:#cfe9ff,stroke:#1d4ed8,stroke-width:1.5px,color:#0b1f3a
  classDef process fill:#dcfce7,stroke:#15803d,stroke-width:1.5px,color:#052e16
  classDef tool fill:#bbf7d0,stroke:#16a34a,stroke-width:1.5px,color:#052e16
  classDef toolFuture fill:#d1fae5,stroke:#059669,stroke-width:1.5px,stroke-dasharray:5 3,color:#064e3b
  classDef manual fill:#fde68a,stroke:#b45309,stroke-width:1.5px,stroke-dasharray:4 3,color:#451a03
  classDef spec fill:#e9d5ff,stroke:#7c3aed,stroke-width:1.5px,color:#2e1065
  classDef store fill:#ffedd5,stroke:#c2410c,stroke-width:1.5px,color:#431407
  classDef folder fill:#fed7aa,stroke:#c2410c,stroke-width:1.5px,color:#431407
  classDef artifact fill:#fff7ed,stroke:#ea580c,stroke-width:1.5px,color:#431407
  classDef doc fill:#e5e7eb,stroke:#374151,stroke-width:1.5px,color:#111827
  classDef docMeta fill:#f3f4f6,stroke:#4b5563,stroke-width:1.5px,color:#111827
  classDef govern fill:#e5e7eb,stroke:#6b7280,stroke-width:1.5px,color:#111827
  classDef actor fill:#f1f5f9,stroke:#334155,stroke-width:1.5px,color:#0f172a
  classDef note fill:#f8fafc,stroke:#94a3b8,stroke-width:1.2px,stroke-dasharray:3 3,color:#0f172a
  classDef root fill:#f1f5f9,stroke:#0f172a,stroke-width:2px,color:#0f172a
```
