{"id":45911060,"url":"https://github.com/nad-bit/mino","last_synced_at":"2026-05-10T09:16:02.106Z","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-05-03T17:08:35.000Z","size":26398,"stargazers_count":17,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-03T19:14:47.701Z","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-05-03T17:08:39.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":40,"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":32622743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"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-05-10T09:16:02.098Z","avatar_url":"https://github.com/nad-bit.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"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.\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 the repo on GitHub, 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 with an intelligent Tag Cloud. Filter your repositories by language, topic, or status instantly using the auto-generated suggestion cloud.\n- **🧠 Quick Add**: Copy a GitHub repository URL, open the menu, and the header intelligently transforms into a \"Quick Add\" action with dynamic iconography. Bypass modal windows completely!\n- **📏 Dynamic Typography**: Choose your preferred text size (10pt to 18pt). The entire menu UI, from repository names to release notes, scales proportionally to ensure perfect legibility for every user.\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 (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\n**Standard Manual Input:**\n- Enter `owner/repo` format (e.g., `microsoft/vscode`).\n- Enter a Homebrew **Cask name** (e.g., `lulu` or `stats`) to automatically resolve and track its GitHub repository. No prefixes required.\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 the release notes on GitHub |\n| ↗ | Open the repository on GitHub |\n| 🗑 | Remove from watch list |\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. It features an intelligent **Tag Cloud** that suggests languages and topics from your collection for instant filtering without typing.\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| **Menu layout** | Segmented control: Choose between 3 distinct UI arrangements (Columns, Cards, Tags) |\n| **Text Size** | Segmented control: Choose your preferred reading comfort (11pt to 18pt) |\n| **Sort by** | Segmented control: Date or Name |\n| **New Release Indicator** | Toggle the ● freshness dot (Columns/Cards) or dynamic pill color (Tags) and configure threshold (1-30 days) |\n| **Show Owner Name** | Toggle `owner/` prefix in repo names |\n| **Refresh Interval** | Slider: 1-24 hours between auto-checks |\n| **Start at Login** | Toggle macOS LaunchAgent |\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## Keyboard Shortcuts\n\nMino is designed for power users. Use these shortcuts while the main menu is open:\n\n| Shortcut | Action |\n|----------|--------|\n| `CMD + ,` | Open Preferences |\n| `CMD + F` | Focus Search field |\n| `CMD + I` | Show Release Notes for selected repo |\n| `CMD + Z` | Undo last repository deletion |\n| `CMD + Q` | Quit Mino |\n| `ESC`     | Close any active popover |\n\n## Architecture\n\nMino uses a modern, coordinator-based architecture driving a fully native **NSPopover** interface with a virtualized **NSTableView** for maximum performance.\n\n```\nSwiftApp/\n├── build.sh                    # Universal build script (ARM64/x86_64)\n└── Sources/\n    ├── AppDelegate.swift               # App lifecycle and Popover management\n    ├── MainPopoverViewController.swift # Main UI controller (Table, Search, Tags)\n    ├── RepoCoordinator.swift           # Logic for adding/deleting/managing repos\n    ├── RefreshCoordinator.swift        # Background update cycle and timers\n    ├── RepoMenuItemView.swift          # Virtualized row view with hover logic\n    ├── SettingsViewController.swift    # App preferences and UI scaling logic\n    ├── ReleaseNotesWindowController.swift # Native markdown-ready notes viewer\n    ├── AddRepoViewController.swift     # Multi-Hunt batch ingestion logic\n    ├── ConfigManager.swift             # JSON persistence and Keychain security\n    ├── GitHubAPI.swift                 # GitHub REST API client\n    ├── HomebrewManager.swift           # Homebrew Cask discovery and CLI bridge\n    ├── Translations.swift              # Localization engine (11 languages)\n    ├── HUDPanel.swift                  # Custom notification overlay\n    ├── Models.swift                    # Data structures (RepoInfo, AppConfig)\n    └── Utils.swift                     # Date logic and window animations\n```\n\n## License\n\nThis project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.\n\n## Credits\n\nNo credits.\n","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"}