# e33io/scripts architecture

> Architecture diagram of the GitHub repository e33io/scripts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/e33io/scripts
- Repository: https://github.com/e33io/scripts

## Overview

##### Main Components Organization

- Installation Scripts (Core)
- Desktop Environment Scripts
- Application Installation Scripts
- Theming Scripts
- Utility Scripts

##### Component Relationships

a) Primary Flow:
- Branching paths to different DE/WM installation scripts

b) Secondary Systems:
- Related scripts (e.g., theming scripts, utility scripts)
- Which scripts are distribution-specific (Debian vs openSUSE)

##### Specific Elements

Create sections for:
a) Distribution-Specific Scripts:
- Debian-based scripts
- openSUSE scripts
- Ubuntu-specific scripts

b) Functionality Groups:
- Window Manager installations (i3, JWM)
- Desktop Environment installations (XFCE, LXQt, MATE, Cinnamon, GNOME)
- Browser installations (Brave, Firefox, LibreWolf)
- System utilities (swap, tearfree, wakelock)

##### Important Relationships to Highlight
- Dependencies between scripts (e.g., theming scripts depending on DE installation)
- Optional components vs. required components
- System modification flows (e.g., display, theme changes)

##### Additional Details
- Notes about script execution requirements (root privileges, prerequisites)
- Version compatibility information
- Scripts that require user interaction

- Entry points at the top
- Core installation scripts in the center
- Utility and optional scripts branching to the sides
- Clear pathways showing different installation combinations

Remember to:
- Keep the abstraction level appropriate (focus on script relationships rather than internal script details)
- Use consistent styling throughout
- Clear labels for all components
- Brief descriptions for key components
- Both mandatory and optional paths clearly

- The overall structure of the script collection
- How different scripts interact and depend on each other
- The various installation paths available
- System modification possibilities
- Distribution-specific considerations

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Entry
        Start["deb-post-install-options.sh"]:::entry
        Setup["deb-post-install-setup.sh"]:::core
    end

    subgraph "Desktop Environments"
        DE_Cinnamon["Cinnamon"]:::de
        DE_GNOME["GNOME"]:::de
        DE_XFCE["XFCE"]:::de
        DE_LXQt["LXQt"]:::de
        DE_MATE["MATE"]:::de
        DE_i3["i3"]:::wm
        DE_JWM["JWM"]:::wm
    end

    subgraph "Browser Installation"
        Browser_Brave["Brave Browser"]:::app
        Browser_Firefox["Firefox"]:::app
        Browser_LibreWolf["LibreWolf"]:::app
    end

    subgraph "Communication Apps"
        Comm_Signal["Signal"]:::app
        Comm_Thunder["Thunderbird"]:::app
    end

    subgraph "Theming"
        Theme_Mint["Mint Themes"]:::theme
        Theme_Yaru["Yaru Themes"]:::theme
        Theme_WM{{"WM Theming"}}:::theme
    end

    subgraph "System Utilities"
        Util_Swap["Swap File"]:::util
        Util_Wake["Wakelock Service"]:::util
        Util_Tear["Tearfree Setup"]:::util
        Util_DPI["DPI Scaling"]:::util
    end

    subgraph "Distribution Specific"
        Dist_Ubuntu["Remove Snapd"]:::dist
        Dist_OpenSUSE["OpenSUSE i3"]:::dist
    end

    Start --> Setup
    Setup --> DE_Cinnamon & DE_GNOME & DE_XFCE & DE_LXQt & DE_MATE & DE_i3 & DE_JWM

    DE_Cinnamon & DE_GNOME & DE_XFCE & DE_LXQt & DE_MATE --> Theme_Mint
    DE_Cinnamon & DE_GNOME & DE_XFCE & DE_LXQt & DE_MATE --> Theme_Yaru
    DE_i3 & DE_JWM --> Theme_WM

    Setup --> Browser_Brave & Browser_Firefox & Browser_LibreWolf
    Setup --> Comm_Signal & Comm_Thunder
    Setup --> Util_Swap & Util_Wake & Util_Tear & Util_DPI

    %% Click Events
    click Start "https://github.com/e33io/scripts/blob/main/deb-post-install-options.sh"
    click Setup "https://github.com/e33io/scripts/blob/main/deb-post-install-setup.sh"
    click DE_Cinnamon "https://github.com/e33io/scripts/blob/main/deb-post-install-cinnamon.sh"
    click DE_GNOME "https://github.com/e33io/scripts/blob/main/deb-post-install-gnome.sh"
    click DE_XFCE "https://github.com/e33io/scripts/blob/main/deb-post-install-xfce.sh"
    click DE_LXQt "https://github.com/e33io/scripts/blob/main/deb-post-install-lxqt.sh"
    click DE_MATE "https://github.com/e33io/scripts/blob/main/deb-post-install-mate.sh"
    click DE_i3 "https://github.com/e33io/scripts/blob/main/deb-post-install-i3.sh"
    click DE_JWM "https://github.com/e33io/scripts/blob/main/deb-post-install-jwm.sh"
    click Browser_Brave "https://github.com/e33io/scripts/blob/main/install-brave-deb.sh"
    click Browser_Firefox "https://github.com/e33io/scripts/blob/main/install-firefox-deb.sh"
    click Browser_LibreWolf "https://github.com/e33io/scripts/blob/main/install-librewolf-deb.sh"
    click Comm_Signal "https://github.com/e33io/scripts/blob/main/install-signal-deb.sh"
    click Comm_Thunder "https://github.com/e33io/scripts/blob/main/install-thunderbird.sh"
    click Theme_Mint "https://github.com/e33io/scripts/blob/main/install-mint-themes.sh"
    click Theme_Yaru "https://github.com/e33io/scripts/blob/main/install-yaru-themes.sh"
    click Theme_WM "https://github.com/e33io/scripts/blob/main/set-i3-theming.sh"
    click Util_Swap "https://github.com/e33io/scripts/blob/main/make-swap-file.sh"
    click Util_Wake "https://github.com/e33io/scripts/blob/main/laptop-wakelock-service.sh"
    click Util_Tear "https://github.com/e33io/scripts/blob/main/setup-tearfree-amd.sh"
    click Util_DPI "https://github.com/e33io/scripts/blob/main/mod-dpi-scaling-lxqt.sh"
    click Dist_Ubuntu "https://github.com/e33io/scripts/blob/main/ubuntu-remove-snapd.sh"
    click Dist_OpenSUSE "https://github.com/e33io/scripts/blob/main/opensuse-post-install-i3.sh"

    %% Styling
    classDef entry fill:#f9f,stroke:#333,stroke-width:2px
    classDef core fill:#fdd,stroke:#333
    classDef de fill:#dfd,stroke:#333
    classDef wm fill:#ddf,stroke:#333
    classDef app fill:#ffd,stroke:#333
    classDef theme fill:#dff,stroke:#333
    classDef util fill:#fdf,stroke:#333
    classDef dist fill:#fff,stroke:#333,stroke-dasharray: 5 5
```
