{"id":45911060,"url":"https://github.com/nad-bit/mino","last_synced_at":"2026-04-14T19:01:17.692Z","repository":{"id":340679636,"uuid":"1167025155","full_name":"nad-bit/Mino","owner":"nad-bit","description":"A fast and lightweight macOS menu bar app to track GitHub releases. Features inline actions and Homebrew integration. Built entirely with Swift and AppKit, zero dependencies.","archived":false,"fork":false,"pushed_at":"2026-04-11T17:02:19.000Z","size":22292,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-11T18:22:37.265Z","etag":null,"topics":["appkit","github-releases","homebrew","mac-app","macos","menubar","no-dependencies","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nad-bit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T21:37:23.000Z","updated_at":"2026-04-11T17:02:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nad-bit/Mino","commit_stats":null,"previous_names":["nad-bit/mino"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/nad-bit/Mino","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nad-bit%2FMino","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nad-bit%2FMino/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nad-bit%2FMino/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nad-bit%2FMino/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nad-bit","download_url":"https://codeload.github.com/nad-bit/Mino/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nad-bit%2FMino/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31810741,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appkit","github-releases","homebrew","mac-app","macos","menubar","no-dependencies","swift"],"created_at":"2026-02-28T06:45:19.274Z","updated_at":"2026-04-14T19:01:17.685Z","avatar_url":"https://github.com/nad-bit.png","language":"Swift","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"docs/icon.png\" width=\"150\" alt=\"Mino Logo\"\u003e\n  \u003c/p\u003e\n  \u003ch1 align=\"center\"\u003eMino\u003c/h1\u003e\n  \u003cp\u003eA lightweight, native macOS menu bar app to track GitHub releases with Homebrew integration. Built entirely with Swift and AppKit — no frameworks, no dependencies, no Xcode project required.\u003c/p\u003e\n  \n  [![macOS](https://img.shields.io/badge/macOS-12.0+-000000?style=flat\u0026logo=apple\u0026logoColor=white)](https://apple.com/macos)\n  [![Swift](https://img.shields.io/badge/Swift-5.0+-FA7343?style=flat\u0026logo=swift\u0026logoColor=white)](https://swift.org)\n  [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\u003c/div\u003e\n\n\nhttps://github.com/user-attachments/assets/3ca0d651-5059-4683-812f-c9f24b8aa8fc\n\n\n## Features\n\n- **👀 Menu Bar Integration**: Unobtrusive status bar icon with inline repository information\n- **⚡️ Inline Actions**: Hover over any repository to reveal contextual action buttons with expanded, easy-to-click target areas — view release notes, open releases, install via Homebrew, or delete\n- **🍺 Homebrew Integration**: Detects installed Casks automatically and enables one-click install/update directly from the menu (only shown if Homebrew is installed)\n- **🧩 Integrated Search**: A sleek, centered search field built directly into the menu header for instant repository filtering.\n- **🧠 Hybrid Quick Add**: Copy a GitHub repository URL, open the menu, and the header intelligently transforms into a \"Quick Add\" action. Bypass modal windows completely!\n- **⏱ Tooltip Tracker**: The refresh countdown is hidden for a cleaner look — simply hover over the refresh icon to see the time remaining.\n- **🎯 Multi-Hunt Window**: The floating \"Add Repositories...\" window acts as a persistent tracking hub. Keep it open while you browse Safari, and simply hit `CMD+C` on sequential GitHub URLs. Mino automatically sniffs your clipboard and queues them up for rapid batch-ingestion without ever losing focus.\n- **📂 Quick Reveal**: After installing a Cask, the app reveals the application in Finder\n- **🔐 Secure Token Storage**: GitHub Personal Access Tokens stored in macOS Keychain — never in plain text\n- **★ Favorites**: Right-click any repository to mark it as a favorite. A gold ★ appears inline — toggles instantly without closing the menu.\n- **🌍 Localized**: English, Spanish, French, German, Italian, Portuguese, Mandarin Chinese, Hindi, Arabic, Russian, and Japanese with automatic system detection\n- **🔄 Auto-Start**: Launch at login via native macOS LaunchAgent\n- **🎨 Light \u0026 Dark Mode**: Full support, including a forced-dark HUD panel for notifications\n\n## Installation\n\n### Prerequisites\n\n- macOS 12.0+\n- Xcode Command Line Tools (`xcode-select --install`)\n- [Homebrew](https://brew.sh/) (optional, for Cask integration)\n\n### Homebrew (Recommended)\n\n```bash\nbrew install nad-bit/tap/mino\n```\n\n### Build from Source\n\n```bash\ngit clone https://github.com/nad-bit/Mino.git\ncd Mino/SwiftApp\nchmod +x build.sh\n./build.sh\n```\n\nThe compiled app bundle will be at `build/Mino.app`. Move it to `/Applications` or run it directly:\n\n```bash\nopen build/Mino.app\n```\n\n\u003e **Note**: No Xcode project needed. The `build.sh` script compiles all Swift sources directly with `swiftc`.\n\n\u003e **Important**: If macOS blocks the compiled application from running (saying it's damaged or cannot be verified), remove the quarantine attribute by running:\n\u003e ```bash\n\u003e xattr -dr com.apple.quarantine /Applications/Mino.app\n\u003e ```\n\n## Usage\n\n### Adding Repositories\n\n**Fastest Way (Hybrid Quick Add):**\n1. Copy any GitHub repository URL to your clipboard.\n2. Click the Mino menu bar icon. A **Quick Add** button will instantly appear at the top.\n3. Click it. You're done.\n\n**Multi-Hunt Way (Batch Processing):**\nClick the `(+)` button in the menu to open the floating Window.\n- Don't close the window! Keep it hovering on your screen.\n- Go to your browser, copy a URL (`CMD+C`). Watch Mino automatically catch the link. Click the Add button.\n- The window remains open and the text field clears. Cycle through your browser tabs, copying and adding rapidly.\n- Includes a cute, animated visual confirmation (`paw swipe`) for successful additions.\n\n**Standard Manual Input:**\n- Enter `owner/repo` format (e.g., `microsoft/vscode`).\n- Toggle the segment to Homebrew to select from your installed Casks.\n\n### Menu Interface\n\nEach repository displays its name, latest version, and time since release. Hover over a row to reveal action buttons aligned to the right:\n\n| Button | Action |\n|--------|--------|\n| 📦 | Install/update via Homebrew (if available) |\n| 📄 | View release notes |\n| ↗ | Open releases page on GitHub |\n| 🗑 | Remove from watch list |\n\nClick the row itself to open the repository's main GitHub page.\n\nRepos with a recent release show a **●** freshness indicator (green / orange / grey) before the name when the *New Release Indicator* option is enabled in Preferences. The threshold (1–30 days) is configurable.\n\nRight-click any row to toggle a **★** favorite mark.\n\n### Filtering\nSimply start typing in the **Integrated Search** field at the top of the menu to filter your repository list in real-time. The search field is compact and accessible without extra clicks.\n\n### Preferences\n\nAccessible via the **Preferences** menu item:\n\n| Option | Description |\n|--------|-------------|\n| **GitHub Account** | Connect via OAuth for 5,000 req/hr limit (vs 60/hr unauthenticated) |\n| **Refresh Interval** | Slider: 1-24 hours between auto-checks |\n| **Start at Login** | Toggle macOS LaunchAgent |\n| **Show Owner Name** | Toggle `owner/` prefix in repo names |\n| **New Release Indicator** | Toggle the ● freshness dot (Columns/Cards) or dynamic pill color (Tags) and configure threshold (1-30 days) |\n| **Sort by** | Segmented control: Date or Name |\n| **Menu layout** | Segmented control: Choose between 3 distinct UI arrangements (Columns, Cards, Tags) |\n| **Compact Menu** | Toggle extreme density (shrinks rows from 22pt to 16pt) |\n\n### System Permissions\n\nMino requires certain macOS permissions to function seamlessly:\n- **Background Activity (Login Items)**: Required to allow the app to run persistently in the menu bar and start automatically when you log into your Mac.\n- **App Management (Privacy \u0026 Security)**: Required because Mino executes background scripts (`brew reinstall`) that modify or install other applications inside your `/Applications` folder. macOS enforces this protection to prevent silent app tampering.\n\n### Security\n\nYour GitHub authentication token is stored securely in **macOS Keychain**:\n- Encrypted, never saved in raw config files\n- Visible in Keychain Access under \"Mino\"\n- Uses GitHub's official Device Authorization Flow (OAuth)\n\n## Configuration\n\nConfiguration is stored in:\n```\n~/.config/Mino/repos.json\n```\n\n\u003e **Note**: Tokens are NOT stored in this file — they're in Keychain.\n\n## Architecture\n\n```\nSwiftApp/\n├── build.sh                    # One-step build script (no Xcode required)\n└── Sources/\n    ├── main.swift              # App entry point\n    ├── AppDelegate.swift       # Menu bar, lifecycle, NSMenuDelegate\n    ├── RepoMenuItemView.swift  # Custom inline menu item with hover actions\n    ├── SettingsWindowController.swift  # Preferences window\n    ├── ConfigManager.swift     # JSON config + Keychain management\n    ├── GitHubAPI.swift         # GitHub REST API client\n    ├── GitHubAuth.swift        # GitHub Device Flow OAuth handling\n    ├── HomebrewManager.swift   # Homebrew Cask detection and installation\n    ├── HUDPanel.swift          # Floating notification panel\n    ├── UIHandlers.swift        # Dialogs and alert helpers\n    ├── Models.swift            # Data structures (RepoInfo, AppConfig)\n    ├── Constants.swift         # App-wide constants\n    ├── Translations.swift      # i18n (English, Spanish, French, German, Italian, Portuguese)\n    └── Utils.swift             # Date formatting utilities\n```\n\n## License\n\nThis project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.\n\n## Credits\n\nBuilt with pure Swift and AppKit. No external dependencies.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnad-bit%2Fmino","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnad-bit%2Fmino","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnad-bit%2Fmino/lists"}