🤖 Update files

Add framework13 Theme

.github/CODE_OF_CONDUCT.md

@@ -60,7 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-adrian.srodon@gmail.com.
+adriansrodon@tuta.io.
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: [AdisonCavani] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+custom: ["https://www.buymeacoffee.com/adisoncavani"]# Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,24 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. Ubuntu 20.10]
- - Resolution [e.g. 1920 x 1080]
-
-**Additional context**
-Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,46 @@
+name: Issue / bug
+description: File a bug/issue
+title: "bug: <title>"
+labels: [bug]
+body:
+- type: checkboxes
+  attributes:
+    label: Is there an existing issue for this?
+    description: Please search to see if an issue already exists for the bug you encountered.
+    options:
+    - label: I have searched the existing issues
+      required: true
+- type: textarea
+  attributes:
+    label: Current Behavior
+    description: A concise description of what you're experiencing.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Expected Behavior
+    description: A concise description of what you expected to happen.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Environment
+    description: |
+      examples:
+        - **OS**: Ubuntu 20.04
+        - **Resolution**: 1920x1080
+    value: |
+        - OS: 
+        - Resolution: 
+    render: markdown
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Anything else?
+    description: |
+      Links? References? Anything that will give us more context about the issue you are encountering!
+
+      Tip: You can attach screenshots or log files by clicking this area to highlight it and then dragging files in.
+  validations:
+    required: false

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,42 @@
+name: Feature request
+description: Suggest an idea for this project
+title: "feat: <title>"
+labels: [feature-request]
+body:
+- type: textarea
+  attributes:
+    label: Is your feature request related to a problem? Please describe
+    description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Describe the solution you'd like
+    description: A clear and concise description of what you want to happen
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Describe alternatives you've considered
+    description: A clear and concise description of any alternative solutions or features you've considered
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Additional context
+    description: Add any other context or screenshots about the feature request here
+  validations:
+    required: false
+- type: dropdown
+  attributes:
+    label: Contributing
+    multiple: false
+    options:
+      - "No, I am afraid I cannot help regarding this"
+      - "Yes, I am willing to help implement this feature in a PR"
+  validations:
+    required: true
+- type: markdown
+  attributes:
+    value: |
+      It takes a lot of work and time maintaining this project; any contribution is welcomed

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+# Description
+
+Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context.
+
+Fixes # (issue)
+
+## Type of change
+
+Please delete options that are not relevant.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] This change requires a documentation update
+
+# Checklist:
+
+- [ ] My code follows the style guidelines of this project (correct file and folder structure)
+- [ ] The background image for theme follows naming convention: `theme_name.png`
+- [ ] I updated [`themes.json`](https://github.com/AdisonCavani/distro-grub-themes/blob/master/themes.json) file (JSON database)

.github/workflows/nix.yml

@@ -0,0 +1,57 @@
+name: Check nix packages
+on:
+    pull_request:
+      paths:
+        - "./*.nix"
+        - ".github/workflows/nix.yml"
+        - "assets/**"
+        - "customize/**"
+    push:
+        branches: [master]
+        paths:
+          - "./*.nix"
+          - ".github/workflows/nix.yml"
+          - "assets/**"
+          - "customize/**"
+jobs:
+    flake:
+        name: Check flake
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - name: Check Nix flake inputs
+              uses: DeterminateSystems/flake-checker-action@v5
+              with:
+                send-statistics: false
+                fail-mode: true
+            - name: Install Nix
+              uses: DeterminateSystems/nix-installer-action@v9
+            - name: Check repository
+              run: nix flake check
+    matrix:
+        name: Generate build matrix
+        runs-on: ubuntu-latest
+        outputs:
+            themes: ${{ steps.generate-matrix.outputs.themes }}
+        steps:
+            - uses: actions/checkout@v4
+            - name: Generate matrix
+              id: generate-matrix
+              run: |
+                THEMES=$(ls assets/backgrounds/ | sed 's/\.png$//g' | jq --raw-input | jq --slurp -c)
+                echo "themes=$THEMES" >> $GITHUB_OUTPUT
+    build:
+        name: Check nix build for theme ${{ matrix.theme }}
+        runs-on: ubuntu-latest
+        needs:
+            - matrix
+        strategy:
+            matrix: 
+                theme: ${{ fromJSON(needs.matrix.outputs.themes) }}
+        steps:
+            - uses: actions/checkout@v4
+            - name: Install Nix
+              uses: DeterminateSystems/nix-installer-action@v9
+            - name: Build package
+              run: nix build .#${{ matrix.theme }}-grub-theme
+

.github/workflows/update-content.yml

@@ -0,0 +1,56 @@
+name: Update changes on commit
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master]
+    paths:
+      - "assets/**"
+      - "customize/**"
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@master
+      - name: 📂 Create temp folder
+        run: |
+          mkdir temp
+      - name: 🖼️ Add backgrounds
+        run: |
+          for file in assets/backgrounds/*.png ; do
+            filename=$(basename "$file" .png)
+            mkdir "temp/$filename"
+            cp "$file" "temp/$filename/background.png"
+          done
+      - name: 🎨 Add icons
+        run: |
+          for dest in temp/* ; do cp -rv assets/icons "$dest"; done
+      - name: 📇 Add fonts
+        run: |
+          for dest in temp/* ; do cp -rva assets/fonts/. "$dest"; done
+      - name: 🌿 Add menu
+        run: |
+          for dest in temp/* ; do cp -rva assets/menu/. "$dest"; done
+      - name: 📃 Add theme
+        run: |
+          for dest in temp/* ; do cp -rv assets/theme.txt "$dest"; done
+      - name: 🗑️ Cleanup old themes
+        run: |
+          rm -rf themes/*
+      - name: 💼 Create archives
+        run: |
+          cd temp;
+          for dest in * ; do find "$dest" -printf "%P\n" | tar -vcf ../themes/"$dest".tar --no-recursion -C "$dest" -T -; done
+      - name: Remove artifacts
+        run: |
+          rm -r temp
+      - name: 🔥 Commit changes
+        run: |
+          git config user.name github-actions
+          git config user.email github-actions@github.com
+          git fetch
+          git add .
+          git commit -m "🤖 Update files"
+          git push

.gitignore

@@ -0,0 +1,4 @@
+.envrc
+.direnv
+.vscode
+result

CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing guide
+
+Thank you for investing your time in contributing to this project! :sparkles:. 
+
+## New contributor guide
+
+To get an overview of the project, read the [README](README.md) and [wiki page](https://github.com/AdisonCavani/distro-grub-themes/wiki).
+
+### Project structure:
+
+```
+.
+├── assets                       - assets for creating background images
+|   ├── backgrounds              - backgrounds used in each theme
+|   ├── fonts                    - fonts
+|   ├── icons                    - icons
+|   ├── menu                     - menu parts
+|   └── theme.txt                - theme configuration file
+├── docs                         - documentation markdown files
+├── preview                      - preview images for README.md
+├── themes                       - compressed themes ready to install in .tar format
+└── themes.json                  - json file containing all themes definitions (used as database for wiki page)
+```
+
+### Workflow
+
+Folders that trigger new action/workflow:
+
+- assets
+- customize
+
+Every time you create new commit on master branch, github action bot will update all files (as defined in [this file](https://github.com/AdisonCavani/distro-grub-themes/blob/master/.github/workflows/update-content.yml)).  
+You can track your workflows [here](https://github.com/AdisonCavani/distro-grub-themes/actions).
+
+### Branches
+
+```
+├── master                       - main branch containing latest changes
+├── legacy                       - obsolete C# program, replaced by Github Actions workflow
+└── templates                    - PSD, phosothop templates for background images
+```
+
+### Frequently Asked Questions
+**Q**: Where are `psd` templates located?  
+**A**: Templates are located in [`templates branch`](https://github.com/AdisonCavani/distro-grub-themes/tree/templates).
+
+**Q**: How can I edit `psd` template? I don't have Photoshop  
+**A**: You can import `psd` into GIMP, however this might cause to lose some Photoshop related data. I recommend to use [Photopea](https://www.photopea.com/) - free web-based Photoshop alternative.

README.md

@@ -1,221 +1,46 @@
 # Distro Grub Themes
+
 [![name](https://img.shields.io/github/license/AdisonCavani/distro-grub-themes)](https://github.com/AdisonCavani/distro-grub-themes/blob/master/LICENSE)
-[![name](https://img.shields.io/github/v/release/AdisonCavani/distro-grub-themes)](https://github.com/AdisonCavani/distro-grub-themes/releases)<br>
-A pack of GRUB2 themes for different Linux distribution and OS.<br>
-It aims to replace default Grub look, with nice and colorful theme.
+[![name](https://img.shields.io/github/v/release/AdisonCavani/distro-grub-themes)](https://github.com/AdisonCavani/distro-grub-themes/releases)
+[![Build](https://github.com/AdisonCavani/distro-grub-themes/actions/workflows/update-content.yml/badge.svg?event=push)](https://github.com/AdisonCavani/distro-grub-themes/actions/workflows/update-content.yml)
+<br>
 
-## Supported distributions
-- Arch Linux
-- Arco Linux
-- Antix Linux
-- CentOS
-- Debian
-- Deepin
-- ElementaryOS
-- EndeavourOS
-- Fedora
-- FreeBSD
-- Garuda
-- Gentoo
-- KDE Neon
-- Linux Mint
-- Manjaro
-- MX Linux
-- openSUSE
-- Pop! OS
-- Rocky Linux
-- Solus
-- Ubuntu
-- Ventoy
-- Void Linux
-- Windows 10
-- Zorin OS
+A pack of GRUB2 themes for different Linux distributions and OSs.<br>
+It aims to replace the default GRUB look, with a nice and colorful theme.
 
-## Preview theme
+## Get started
 
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/grub-theme/master/preview/Arch%20Linux.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Arco%20Linux.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Artix%20Linux.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/CentOS.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Debian.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Deepin.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/ElementaryOS.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/EndeavourOS.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Fedora.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/FreeBSD.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Garuda.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Gentoo.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/KDEneon.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Linux%20Mint.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Manjaro.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/MX%20Linux.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/openSUSE.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/popOS.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Rocky%20Linux.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Solus.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Ubuntu.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Void%20Linux.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Ventoy.png" width="49%"/>
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/Windows%2010.png" width="49%"/>
-</p>
-<p float="left">
-<img src="https://raw.githubusercontent.com/AdisonCavani/distro-grub-themes/master/preview/ZorinOS.png" width="49%"/>
-</p>
+- **Theme preview** is available at [k1ng.dev/distro-grub-themes/preview](https://k1ng.dev/distro-grub-themes/preview).  
+- **Documentation** is available at [k1ng.dev/distro-grub-themes](https://k1ng.dev/distro-grub-themes).  
+- Raw markdown files are located in [`/docs`](./docs) folder.
 
+## Funding
+I put a lot of effort and my free time into maintaining this project.  
+If you appreciate that, you can buy me a coffee.
 
+[<img src="https://www.buymeacoffee.com/assets/img/guidelines/download-assets-sm-1.svg" alt="Buy Me A Coffee" height="50px" />](https://www.buymeacoffee.com/adisoncavani)
 
-## Installation via Grub Customizer
+## Contributing
 
-In order to clone repository from Github you have to install `git` package <br>
-Alternatively you can download zip package - **Code -> Download ZIP**
+Development happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements.  
+Read below to learn how you can take part in improving it.
 
-#### Clone the repository
-You can clone repository or go to [release page](https://github.com/AdisonCavani/distro-grub-themes/releases) and download a single theme
-```
-git clone https://github.com/AdisonCavani/distro-grub-themes.git
-```
+### Code of Conduct
 
-### Install Grub Customizer
+This project has adopted a Code of Conduct that we expect project participants to adhere to.  
+Please read [the full text](https://github.com/AdisonCavani/distro-grub-themes/blob/master/.github/CODE_OF_CONDUCT.md) so that you can understand what actions will and will not be tolerated.
 
-Apt
-```
-sudo add-apt-repository ppa:danielrichter2007/grub-customizer
-sudo apt-get update
-sudo apt-get install grub-customizer
-```
-Pacman
-```
-sudo pacman -S grub-customizer
-```
+### Contributing Guide
 
-Dnf
-```
-sudo dnf install grub-customizer
-```
+Read [contributing guide](https://github.com/AdisonCavani/distro-grub-themes/blob/master/CONTRIBUTING.md) to learn how to propose changes, bugfixes and improvements.
 
-Eopkg
-```
-sudo eopkg install grub-customizer
-```
-### Install pre-made theme with Grub Customizer
+### License
+This project is licensed under [GNU General Public License v3.0](https://github.com/AdisonCavani/distro-grub-themes/blob/master/LICENSE)
 
-- Open Grub Customizer
-- Go to **Appearance settings** tab
-- Select *Custom resolution* and type in your resolution. E.g: 1920x1080
-- Press *Add theme* button, go to your directory, where you have cloned repository. In my case `/home/adison/distro-grub-theme`
-- Select your theme located in `/themes` directory
-- Save changes
+### Contributors
 
-### Install custom-made theme with Grub Customizer
+Thank you to all the people who already contributed to this project!
 
-- Edit your theme located in `/customize` folder
-- With your file manager, inside edited theme directory, select all files and **create archive** with .tar or .tar.xz extension
-- Open Grub Customizer
-- Go to **Appearance settings** tab
-- Enable *Custom resolution* checkbox and select your resolution or type it in manually. E.g: 1920x1080
-- Press *Add theme* button, go to your directory, where you have cloned repository. In my case `/home/adison/distro-grub-theme`
-- Change view settings from *Archive files* to **All files**
-- Select your archive
-- Save changes
-
-
-## Manual Installation
-
-In order to clone repository from Github you have to install `git` package <br>
-Alternatively you can download zip package - **Code -> Download ZIP**
-
-#### Clone the repository
-You can clone repository or go to [release page](https://github.com/AdisonCavani/distro-grub-themes/releases) and download a single theme
-```
-git clone https://github.com/AdisonCavani/distro-grub-themes.git
-```
-
-#### Create themes directory
-```
-sudo mkdir /boot/grub/themes
-```
-
-#### Edit or use pre-made theme
-```
-cd distro-grub-themes/customize
-```
-
-#### Copy theme
-Theme must be unpacked (in folder)
-```
-sudo cp -r ubuntu/ /boot/grub/themes
-```
-
-#### Edit Grub config
-You can use your favourite text editor
-```
-sudo nano /etc/default/grub
-```
-Uncomment this line and set your resolution:
-```
-GRUB_GFXMODE=1920x1080
-```
-
-At the end of file add theme path:
-```
-GRUB_THEME="/boot/grub/themes/ubuntu/theme.txt"
-```
-Replace "ubuntu" with selected theme<br>
-Ctrl+O to save, Ctrl+X to exit
-
-#### Update Grub config
-You will need to tell Grub to update its configuration to include the new theme.
-
-Ubuntu and Debian-based systems:
-
-```
-sudo update-grub
-```
-
-Other Linux distro:
-
-```
-sudo grub-mkconfig -o /boot/grub/grub.cfg
-```
-
-## Install theme in Ventoy
-Extract ```Ventoy.tar``` to ```/ventoy/theme``` directory
-
-Locate ```ventoy.json``` file in ```/plugin/ventoy/``` directory and change:
-```
-"file": "/ventoy/theme/blur/theme.txt",
-```
-to
-```
-"file": "/ventoy/theme/Ventoy/theme.txt",
-```
-For more information head over to [Ventoy website](https://www.ventoy.net/en/plugin_theme.html)
-
-## To-do list
-Feature | Status
------------- | -------------
-4K & 2K displays support | In the future
-Ultrawide display support | In the future
+<a href="https://github.com/AdisonCavani/distro-grub-themes/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AdisonCavani/distro-grub-themes" />
+</a>