Initial commit

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,6 @@
+# Screens PR
+> I certify that these images I'm adding have been tested at [tailor.trmnl.com](https://tailor.trmnl.com)
+
+For all imagery used in these images, I have the right to publish them as CC0 licensed files. 
+**OR**
+All imagery is Public Domain and was sourced here:  

.github/workflows/validate-images.yml

@@ -0,0 +1,53 @@
+name: Image Validation and Gallery Update
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    paths:
+      - 'screens/800x480/**'
+
+jobs:
+  process-images:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: true
+
+      - name: Checkout LFS objects
+        run: git lfs checkout
+
+      - name: Install ImageMagick
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y imagemagick
+
+      - name: Validate PNG dimensions
+        run: |
+          # Find all pngs in the 800x480 directory
+          FILES=$(find screens/800x480 -name "*.png")
+          for FILE in $FILES; do
+            echo "Validating $FILE"
+            # Extract dimensions
+            DIMENSIONS=$(identify -format "%wx%h" "$FILE")
+            if [ "$DIMENSIONS" != "800x480" ]; then
+              echo "::error file=$FILE::Invalid dimensions: $DIMENSIONS. Must be 800x480."
+              exit 1
+            fi
+          done
+
+      - name: Generate Gallery
+        run: python3 generate_gallery.py
+
+      - name: Commit and Push Gallery
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        run: |
+          git config --global user.name "Gallery Bot"
+          git config --global user.email "bot@github.com"
+          git add GALLERY_800x480.md
+          git diff --quiet && git diff --staged --quiet || (git commit -m "docs: update 800x480 gallery" && git push)

README.md

@@ -0,0 +1,47 @@
+# Tailor your TRMNL
+
+This repository contains the source code that lets you tailor your TRMNL. This works by creating a brand binary on your browser and updating the brand binary on the device directly without downloading / installing / modifying the [firmware](https://github.com/usetrmnl/trmnl-firmware) source code.
+
+## Supported Changes
+You can make customizations to the following brand attributes 
+1. API Base URL (coming soon)
+2. Logo
+3. Loading Icon
+
+## How to get started?
+1. Clone this repository
+2. `git submodule init`
+3. `git submodule update`
+4. Install emscripten eg: `brew install emscripten`
+5. Compile and create a wasm file `bash build.sh`
+6. open `index.html` on your browser.
+
+# Community Screens
+[tailor.trmnl.com](https://tailor.trmnl.com/)
+Customize TRMNL with Tailor, our firmware tool that writes custom splash and loading screens for your TRMNL device.
+
+## Devices Supported
+- TRMNL OG (800x480)
+
+## Folder and File Structure
+```
+screens/
+├─ 800x480/
+│  ├─ CATEGORY/
+│  │  ├─ splash/
+│  │  ├─ loading/
+```
+> New categories and subsequent folders can be created as part of a Pull Request.
+
+### Filename Structure
+Hyphen separated sections, with underscore for spaces within a section. _Credit is optional._
+**WIDTHxHEIGHT-TYPE-UNIQUE_NAME-CREDIT?.png**
+_e.g._ 
+`800x480-splash-dungeon_crawler_carl_safehouse-mashermello.png`
+`800x480-loading-dungeon_crawler_carl_princess_donut.png`
+
+## License
+Any PR'd screens will fall under either CC0 (you own the rights and choose this license) or Public Domain licensing for us to be able to host them and have traceability.
+
+## View the Gallery
+- [800x480 Screens](https://github.com/usetrmnl/tailor/blob/master/GALLERY_800x480.md)

generate_gallery.py

@@ -0,0 +1,59 @@
+import os
+import urllib.parse
+
+# Configuration
+BASE_DIR = "screens/800x480"
+OUTPUT_FILE = "GALLERY_800x480.md"
+REPO_URL = "https://github.com/usetrmnl/tailor/raw/main"
+
+def generate_gallery():
+    # Adjusted title and back-link reference for the specific size
+    markdown = [
+        "# 🖼️ 800x480 Screen Gallery",
+        "Browse and download splash and loading screens for TRMNL OG. All images are pre-validated to **800x480 PNG**.\n",
+        "> **Tip:** Right-click 'Download' and select 'Save Link As...' to save directly to your device.\n"
+    ]
+    
+    if not os.path.exists(BASE_DIR):
+        print(f"Directory {BASE_DIR} not found. Skipping.")
+        return
+
+    # Table of Contents
+    categories = sorted([d for d in os.listdir(BASE_DIR) if os.path.isdir(os.path.join(BASE_DIR, d))])
+    markdown.append("### 📂 Categories")
+    for cat in categories:
+        markdown.append(f"- [{cat.replace('_', ' ').title()}](#{cat.lower()})")
+    markdown.append("\n---\n")
+
+    for category in categories:
+        cat_name = category.replace('_', ' ').title()
+        markdown.append(f"## <a name='{category.lower()}'></a>{cat_name}")
+        markdown.append("| Type | Preview | Action |")
+        markdown.append("| :--- | :--- | :--- |")
+        
+        cat_path = os.path.join(BASE_DIR, category)
+        for sub in ["splash", "loading"]:
+            sub_path = os.path.join(cat_path, sub)
+            if os.path.exists(sub_path):
+                files = sorted([f for f in os.listdir(sub_path) if f.lower().endswith('.png')])
+                for f in files:
+                    img_path = f"{sub_path}/{f}"
+                    encoded_path = urllib.parse.quote(img_path)
+                    download_url = f"{REPO_URL}/{encoded_path}"
+                    
+                    # Using HTML for controlled scaling in the Markdown table
+                    preview = f'<img src="{img_path}" width="200" alt="{f}">'
+                    download_link = f"**[💾 Download]({download_url})**"
+                    
+                    markdown.append(f"| {sub.capitalize()} | {preview} | {download_link}<br>`{f}` |")
+        
+        # Anchor link back to the specific 800x480 header
+        markdown.append("\n[↑ Back to Top](#-800x480-screen-gallery)\n")
+        markdown.append("---\n")
+
+    with open(OUTPUT_FILE, "w") as f:
+        f.write("\n".join(markdown))
+    print(f"Successfully generated {OUTPUT_FILE}")
+
+if __name__ == "__main__":
+    generate_gallery()