bun run icon: save an app's icon from a link or its download; fill 126 missing icons

CONTRIBUTING.md

@@ -105,6 +105,8 @@ Use clear upstream app icons and screenshots, with readable screenshots and desc
 
 Every image file needs an `assets` entry with its original source URL, owner credit, and applicable license. Code and image licenses may differ; verify both. The `icon` field is optional and `screenshots` can be empty. Third-party images retain their upstream license and trademark rights.
 
+To add or replace an icon, run `bun run icon <slug> <link>` on a Mac. The link can be the icon file (PNG, JPEG or `.icns`; a GitHub file page works) or the app's official `.dmg` or `.zip` download, from which the icon the app itself declares is used. The command saves a 256 px `assets/icon.png`, records the link, credit and license in `assets`, and refuses images that are not square, smaller than 128 px, or macOS's generic app icon. Use `--credit` and `--license` when the defaults (the record's existing credit and "<license>; upstream app icon, trademarks retained") are wrong. It cannot tell an app's own icon from another product's logo; check that yourself.
+
 An app's official icon may be used even when its logo is reserved as a trademark or carries a non-commercial or no-derivatives license: OpenMacApps is non-commercial and shows the icon only to identify the app it links to. Use the official file unmodified (resizing or format conversion only), name the rights holder in `credit`, and state the actual terms in `license`, for example "Trademark of Mozilla Foundation; not covered by the MPL-2.0 code license". Remove the icon if the rights holder asks. For screenshots and every other image, if reuse rights are unclear, omit the image and explain the gap in your pull request.
 
 Asset paths must begin with `./assets/`, remain inside the app folder, and point to existing files. Symlinks and path traversal are rejected. List provenance even for images not currently shown. Keep the applicable upstream license notices as `.txt` files in `assets/`; the build preserves and links each notice. The build copies these files into `public/catalog/`; do not edit generated copies.

content/apps/ada-studio/index.md

@@ -21,6 +21,12 @@ sources:
   - "https://github.com/AdaEngine/Ada/blob/main/LICENSE"
   - "https://github.com/AdaEngine/Ada/releases/tag/editor-v1.0.0-20261013"
   - "https://adaengine.org"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/AdaEngine/Ada/releases/download/editor-v1.0.0-20261013/AdaEngine-1.0.0-20261013-macOS.zip
+    credit: Ada Studio contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Ada Studio is the companion editor for AdaEngine, an open-source game engine written in Swift for 2D and 3D games and user interfaces. It creates projects, edits code and scenes, and runs games from a desktop or mobile workspace. The engine is a Swift package for developers; the macOS download in the editor release is the Studio app.

content/apps/ai-monitor/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/tobymarks/esp32-ai-monitor/blob/main/LICENSE"
   - "https://github.com/tobymarks/esp32-ai-monitor/releases"
   - "https://tobymarks.github.io/esp32-ai-monitor/"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/tobymarks/esp32-ai-monitor/releases/download/app-v1.32.0/AIMonitor.dmg
+    credit: AI Monitor contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 AI Monitor is the Mac side of a desk display. It asks the local CodexBar CLI for usage limits from providers such as Claude, ChatGPT, Gemini, Copilot and Cursor, then sends a compact frame over USB to a Cheap Yellow Display or a Guition ESP32-S3 board, which draws the dashboard. It is for people who want their limits on a second screen instead of a browser tab. The app does not talk to any AI service directly; CodexBar does.

content/apps/amtrino/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/arian-shamaei/amtrino"
   - "https://github.com/arian-shamaei/amtrino/blob/main/LICENSE"
   - "https://github.com/arian-shamaei/amtrino/releases"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/arian-shamaei/amtrino/releases/download/v0.3.1/amtrino-0.3.1.zip
+    credit: amtrino contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 amtrino puts a small grid of dots in the menu bar, one for each Claude Code or Codex CLI session on the Mac. Colour tells the sessions apart, motion shows which ones are mid-response, and a finished response flashes the dot and can trigger a notification that jumps to that session's tmux pane. It suits people who run many coding-agent sessions at once and would rather glance at the menu bar than cycle through terminal windows.

content/apps/anki-miner/index.md

@@ -19,6 +19,12 @@ sources:
   - "https://github.com/0xzerolight/anki_miner"
   - "https://github.com/0xzerolight/anki_miner/blob/main/LICENSE"
   - "https://github.com/0xzerolight/anki_miner/releases"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/0xzerolight/anki_miner/blob/main/anki_miner/gui/resources/icons/anki_miner.icns
+    credit: Anki Miner contributors
+    license: GPL-3.0; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Anki Miner reads the subtitles of a video, an audiobook or a book, splits the text into words, and skips the ones you already know. For each remaining word it can attach a screenshot, an audio clip and a dictionary definition, then sends the finished cards to Anki. Definitions come from offline dictionaries you add, such as Yomitan dictionaries. It has a desktop GUI and is aimed at people learning a language from native media.

content/apps/app-monitor/index.md

@@ -19,6 +19,12 @@ sources:
   - "https://github.com/jcranokc/app-monitor"
   - "https://github.com/jcranokc/app-monitor/blob/main/LICENSE"
   - "https://github.com/jcranokc/app-monitor/releases/tag/v1.2.0-beta.5"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/jcranokc/app-monitor/releases/download/v1.2.0-beta.5/App-Monitor-Beta.dmg
+    credit: App Monitor contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 App Monitor puts several app-related views in one SwiftUI dashboard. It tracks foreground app usage over time, scans each app's bundle and its support, cache, preference and container folders, flags health issues such as signing and Gatekeeper problems, and checks for updates across the Mac App Store, Homebrew, Sparkle feeds and Apple software update. Its uninstall planner lists the files an app leaves behind before moving the selected ones to the Trash. Cleanup candidates go to an app quarantine first, where you can restore them from History.

content/apps/ask-key/index.md

@@ -21,6 +21,12 @@ sources:
   - "https://github.com/sudoHG/AskKey/blob/main/LICENSE"
   - "https://github.com/sudoHG/AskKey/releases/latest"
   - "https://askkey.sudohg.com/"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/sudoHG/AskKey/releases/download/v0.6.0/AskKey-0.6.0.dmg
+    credit: Ask Key contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Ask Key stores API keys, tokens, passwords and files such as SSH keys in an encrypted local library. Coding agents such as Claude Code, Codex, Cursor and Grok CLI find credentials through an MCP server, and each credential has one permission: allow, ask every time (the default), or hidden. A program that is approved receives the value as an environment variable or a short-lived private file, and the agent receives only the program's output. Timed allowances can cover one credential or a group. It is meant for developers whose agents deploy code or call APIs and who would otherwise paste keys into prompts or `.env` files.

content/apps/atomic-agent/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/AtomicBot-ai/atomic-agent/blob/main/LICENSE"
   - "https://github.com/AtomicBot-ai/atomic-agent/releases"
   - "https://atomicagent.io"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/AtomicBot-ai/atomic-agent/releases/download/desktop-v0.0.7/Atomic-Agent-0.0.7-arm64-mac.zip
+    credit: Atomic Agent contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Atomic Agent is an AI agent that runs its control loop and state on your own machine. It can browse the web, read and edit files, run shell commands after you approve them, and keep sessions, memory and tasks between runs. Models run through llama.cpp on the machine by default; cloud providers are optional, and its Fusion mode lets one model plan while workers run on a second provider. It suits people who want an agent they can inspect and run on their own hardware, and it ships as a terminal interface and a desktop app built on the same agent.

content/apps/beagleeditor-legacy/index.md

@@ -24,6 +24,12 @@ sources:
   - "https://raw.githubusercontent.com/beagleeditor/legacy/main/README.md"
   - "https://github.com/beagleeditor/legacy/releases/tag/v2024.4.0.1"
   - "https://github.com/beagleeditor/editor"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/beagleeditor/legacy/releases/download/v2024.4.0.1/BeagleEditor.2024.4.0.1.dmg
+    credit: BeagleEditor Legacy contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 BeagleEditor Legacy opens a source file for editing with syntax highlighting and autocomplete, and it runs Python files from inside the editor. It is the first BeagleEditor, a code editor written in Python. Its developers renamed it when they released a new BeagleEditor in a separate repository, beagleeditor/editor.

content/apps/betterairdrop/index.md

@@ -21,6 +21,12 @@ sources:
   - "https://github.com/MoizAhmedd/betterairdrop/blob/main/LICENSE"
   - "https://github.com/MoizAhmedd/betterairdrop/releases"
   - "https://betterairdrop.com"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/MoizAhmedd/betterairdrop/releases/download/v0.4.2/BetterAirdrop.zip
+    credit: BetterAirdrop contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 BetterAirdrop renames photos that arrive through AirDrop in Downloads. A name such as `IMG_4821.HEIC` becomes one built from the date, city, kind of image and what it shows, HEIC files are converted to JPEG, and the originals go to the Trash. Undo is available from the menu or the notification. Naming uses Apple Vision on the Mac, Apple Intelligence on macOS 26 or later, or an Anthropic API key if one is set. It is for people who receive many photos by AirDrop and want to find them by name later.

content/apps/biscotti/index.md

@@ -26,6 +26,12 @@ sources:
   - "https://github.com/scosman/Biscotti/blob/main/LICENSE.md"
   - "https://github.com/scosman/Biscotti/releases"
   - "https://biscottiapp.com"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/scosman/Biscotti/releases/download/v1.0.0/Biscotti.dmg
+    credit: Biscotti contributors
+    license: PolyForm-Perimeter-1.0.1; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Biscotti records the Mac's microphone and system audio during a meeting, so it works with apps such as Zoom, Teams, Meet, FaceTime and Slack without joining the call as a participant. It turns the recording into a transcript split by speaker, uses your calendar to suggest when to start and to match names, and writes a summary with action items and a meeting title. Notes can be written in Markdown and linked to the moment they were taken. It is for people who want meeting notes that stay on their own Mac.

content/apps/blave/index.md

@@ -21,6 +21,12 @@ sources:
   - "https://github.com/Blave-TW/blave-agent/blob/main/LICENSE"
   - "https://github.com/Blave-TW/blave-agent/releases"
   - "https://blave.org"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/Blave-TW/blave-agent/releases/download/desktop-v0.1.48/Blave-0.1.48-universal.dmg
+    credit: Blave contributors
+    license: Apache-2.0; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Blave Agent is a workspace for trading strategies. You describe an idea to Claude Code, Codex, a DeepSeek key or Blave's own AI, and the agent writes the strategy, backtests it with fees included and checks the result for overfitting. Strategies can run in paper trading without keys, or be connected to supported exchanges for live orders. It suits traders who want an AI coding agent to do the scripting and testing work.

content/apps/bonk/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/Alex-duh/Bonk/blob/main/LICENSE"
   - "https://github.com/Alex-duh/Bonk/releases"
   - "https://trybonk.vercel.app/"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/Alex-duh/Bonk/blob/main/Packaging/logo.png
+    credit: Bonk contributors
+    license: GPL-3.0; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Bonk reads the accelerometer that Apple silicon MacBooks already contain and treats one to four knocks anywhere on the chassis as separate triggers. Each pattern can run a media or system key, a keyboard shortcut, an app, a shell command or a Shortcuts shortcut, and per-app rules can override the global mapping. Knock calibration, a test mode and a live waveform help set the threshold. Knock detection runs on the Mac; the only network request is an optional daily version check. It suits people who want a physical shortcut for everyday controls such as play, pause or lock.

content/apps/browseroute/index.md

@@ -21,6 +21,12 @@ sources:
   - "https://github.com/TerrifiedBug/browseroute/blob/main/LICENSE"
   - "https://github.com/TerrifiedBug/browseroute/releases"
   - "https://browseroute.terrifiedbug.com"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/TerrifiedBug/browseroute/releases/download/v0.2.0/Browseroute-0.2.0.zip
+    credit: Browseroute contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Browseroute registers as the default web browser and hands each `http` and `https` link to the browser you choose. Rules match a host suffix, a host glob or a host plus path glob, and are tried from top to bottom; a link that matches nothing goes to a Default browser you mark. It can also appear as an Open With option in Finder for common document and image types. It suits people who keep work and personal accounts in separate browsers and want links to open in the right one.

content/apps/browsync/index.md

@@ -19,6 +19,12 @@ sources:
   - "https://github.com/chentao1006/BrowSync/blob/main/LICENSE"
   - "https://github.com/chentao1006/BrowSync/releases"
   - "https://browsync.ct106.com/"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/chentao1006/BrowSync/releases/download/v1.3.1/BrowSync.dmg
+    credit: BrowSync contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 BrowSync can be set as the default browser on a Mac. It opens each link in Safari, a Chromium-based browser or Firefox, chosen by domain, URL pattern, source app or time of day. It also syncs bookmarks, cookies, local storage and open tabs between those browsers. It suits people who move between several browsers and want their data kept in step.

content/apps/bzz/index.md

@@ -22,6 +22,12 @@ sources:
   - "https://github.com/zlopixatel/bzz/blob/main/LICENSE"
   - "https://github.com/zlopixatel/bzz/releases"
   - "https://zlopixatel.github.io/bzz/"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/zlopixatel/bzz/releases/download/v0.3.0/Bzz.dmg
+    credit: Bzz contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Bzz is a menu bar app that notices when a word was typed in the wrong keyboard layout, such as Latin keys pressed while Russian was meant, and retypes it in the right layout when you press Space or punctuation. It checks words against a Russian dictionary with stemming and accepts a single typo in words of six or more letters. Cmd+Z reverts a correction within five seconds, and the tray icon pauses it. It suits people who switch between Russian and English layouts. The README says Windows support is planned.

content/apps/caffeinatecat/index.md

@@ -22,6 +22,12 @@ sources:
   - "https://github.com/PremPoddar/CaffeinateCat/blob/main/LICENSE"
   - "https://github.com/PremPoddar/CaffeinateCat/releases"
   - "https://prempoddar.github.io/CaffeinateCat/"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/PremPoddar/CaffeinateCat/releases/download/v1.1.0/CaffeinateCat.zip
+    credit: CaffeinateCat contributors
+    license: Apache-2.0; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 CaffeinateCat is a menu bar app with two keep-awake modes. Keep Screen Awake stops idle and display sleep. Keep Awake on Lid Close also keeps the Mac running with the lid shut, even on battery, by setting the `disablesleep` flag through `pmset`. Both modes support timers and an option to let the display sleep, and the app switches itself off at 20% and 10% battery. It suits builds, downloads, servers and coding agents that must keep running while the laptop is carried in a bag.

content/apps/chaos/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/michaelmjhhhh/Chaos"
   - "https://github.com/michaelmjhhhh/Chaos/blob/main/LICENSE"
   - "https://github.com/michaelmjhhhh/Chaos/releases"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/michaelmjhhhh/Chaos/releases/download/v1.1.0/Chaos.dmg
+    credit: Chaos contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Chaos watches for new screenshots, asks a vision model for a short description of each one, and renames the file from it, for example `terminal-git-log_143022.png`. Renamed files go to an output folder you choose, optionally in daily or monthly subfolders. The provider can be any OpenAI-compatible vision API, such as OpenAI, OpenRouter or DeepSeek, or Ollama running on your Mac. Every rename is recorded in a local history with undo and retry, and existing files are never overwritten. It is for people whose desktop fills up with screenshots named by date and time.

content/apps/chargemonitor/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/CrashSystemZ/ChargeMonitor"
   - "https://github.com/CrashSystemZ/ChargeMonitor/blob/main/LICENSE"
   - "https://github.com/CrashSystemZ/ChargeMonitor/releases"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/CrashSystemZ/ChargeMonitor/releases/download/v1.2.0/ChargeMonitor.dmg
+    credit: ChargeMonitor contributors
+    license: MIT; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 ChargeMonitor is a menu-bar utility that shows the battery percentage and opens a popover with more detail: power source and adapter, charging state and wattage, power draw, cycle count and time remaining. It also lists apps with significant energy impact, which the author describes as a heuristic built from CPU time, wakeups and disk activity rather than a precise measurement. It is for people who want more battery information than the system menu shows.

content/apps/cida/index.md

@@ -20,6 +20,12 @@ sources:
   - "https://github.com/Xuanwo/cida/blob/main/LICENSE"
   - "https://github.com/Xuanwo/cida/releases/tag/v1.6.0"
   - "https://cida.xuanwo.io"
+assets:
+  - path: ./assets/icon.png
+    source: https://github.com/Xuanwo/cida/releases/download/v1.6.0/Cida-1.6.0-222.dmg
+    credit: Cida contributors
+    license: Apache-2.0; upstream app icon, trademarks retained
+icon: ./assets/icon.png
 ---
 
 Cida (辞达 in its Chinese interface) works on selected text in any app. Option-A opens a panel that translates the selection, and Option-F rewrites it in place, with Command-Z to undo. Option-S translates text inside a captured screen region, and Option-D translates a paragraph in place; Shift-Option-D translates a whole window as it scrolls. You can add your own text actions as prompts. Cida sends text only to the model service you choose, which can be a hosted API or a local server, and it recognises screenshot text on the Mac with Apple's Vision framework. It also includes a command-line interface that shares the app's configuration.