{"id":50734252,"url":"https://github.com/potatoinfinity/flux","last_synced_at":"2026-06-10T12:01:59.157Z","repository":{"id":355146733,"uuid":"1226946530","full_name":"PotatoInfinity/Flux","owner":"PotatoInfinity","description":"An open-source, premium, glassmorphic macOS productivity dashboard for your menu bar. Instant file creation, searchable clipboard history with privacy controls, snippet library, system color picker, multi-note scratchpad, and Finder path integration — all in one native SwiftUI app. Universal binary (Apple Silicon + Intel).","archived":false,"fork":false,"pushed_at":"2026-05-02T03:52:05.000Z","size":1587,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T05:33:20.579Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PotatoInfinity.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-05-02T02:28:16.000Z","updated_at":"2026-05-02T03:52:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/PotatoInfinity/Flux","commit_stats":null,"previous_names":["potatoinfinity/flux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/PotatoInfinity/Flux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PotatoInfinity%2FFlux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PotatoInfinity%2FFlux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PotatoInfinity%2FFlux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PotatoInfinity%2FFlux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PotatoInfinity","download_url":"https://codeload.github.com/PotatoInfinity/Flux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PotatoInfinity%2FFlux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34151276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-06-10T12:01:55.076Z","updated_at":"2026-06-10T12:01:59.152Z","avatar_url":"https://github.com/PotatoInfinity.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flux\n\n**Flux** is a premium, glassmorphic productivity dashboard for macOS that lives quietly in your menu bar. It consolidates fragmented workflows — file creation, clipboard management, snippets, color picking, and note-taking — into a single, high-performance interface.\n\u003cvideo src=\"https://github.com/user-attachments/assets/180400cb-2b2b-42cc-9807-50cf96ccd7f0\" controls muted width=\"100%\"\u003e\u003c/video\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/f1b88a5e-8e71-44ab-8b23-e19a375a4005\" controls muted width=\"49%\"\u003e\u003c/video\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/32d99915-b2d6-4dc6-b981-392ec8070784\" controls muted width=\"49%\"\u003e\u003c/video\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/42af5d4f-05bd-47dd-b110-44a3eed37236\" controls muted width=\"49%\"\u003e\u003c/video\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/a5f932e1-ab19-4ae5-afd7-fbb068653a39\" controls muted width=\"49%\"\u003e\u003c/video\u003e\n\u003c/div\u003e\n\n\u003cvideo src=\"https://github.com/user-attachments/assets/c7d1005d-c812-4ce5-9e39-59616be02c98\" controls muted width=\"100%\"\u003e\u003c/video\u003e\n\n---\nDon't want to build from source? **[Download the latest compiled `.dmg` from the Releases section](https://github.com/PotatoInfinity/Flux/releases/tag/v1.0)**.\n\n---\n\n## Key Features\n\n### Instant File Creation\n*   **One-Tap Creation**: Create `.html`, `.swift`, `.json`, and more in your active Finder window with a single click.\n*   **Drag \u0026 Drop**: Drag file type icons directly from Flux into any folder to create a new file instantly.\n*   **Custom Extensions**: Type any extension (`.go`, `.rs`, `.tsx`) via the \"Other\" tile.\n\n### Intelligent Clipboard\n*   **Deep History**: Automatically tracks everything you copy — configurable up to 5,000 items.\n*   **Searchable**: Instantly find anything from your history with the built-in search bar.\n*   **One-Click Restore**: Click any item to put it back on your active pasteboard.\n*   **Delete Items**: Remove individual entries with a single tap, or clear the entire history at once.\n*   **Privacy Protection**: Flux automatically ignores content copied from password managers and macOS Keychain (respects the `org.nspasteboard.ConcealedType` standard).\n*   **App Blacklist**: Choose specific applications whose clipboard content should never be saved — configurable from a searchable list of every app installed on your device.\n\n### Snippet Library\n*   **Reusable Templates**: Save emails, boilerplate code, or frequently used text as named snippets.\n*   **One-Click Copy**: Tap any snippet to instantly load it onto your clipboard.\n*   **Edit \u0026 Delete**: Full inline editing and deletion with confirmation dialogs.\n\n### Scratchpad\n*   **Multi-Note**: Manage multiple named notes with a collapsible sidebar.\n*   **Auto-Hiding Sidebar**: Hover the left edge to reveal the notes list; it stays out of your way when you're writing.\n*   **Instant Persistence**: All notes are saved to disk immediately.\n\n### Design Toolkit\n*   **System-Wide Eyedropper**: Pick any pixel color on your screen.\n*   **Format Converter**: Instantly get HEX, RGB, and HSL values — click each to copy.\n*   **Color History**: Remembers your recently picked colors.\n\n### Finder Integration\n*   **Copy Exact Path**: Installs a native macOS Quick Action that lets you right-click any file in Finder and copy its full POSIX path to the clipboard instantly — no Terminal needed.\n\n### Localization\n*   **Context-Aware Translation Engine**: Localizes the entire UI into dozens of languages on the fly using the Google Translate API, with smart caching for offline use.\n*   **Protected Terms**: `Flux`, `Copy Exact Path`, and `Services` are always preserved in their original form, regardless of language.\n*   **Set in Onboarding**: Choose your language on first launch.\n\n---\n\n## ⌨️ Shortcuts \u0026 Interaction\n\n| Action | Default Shortcut |\n| :--- | :--- |\n| **Show / Hide Flux** | Tap `Control` |\n| **Switch to Tab 1–5** | `⌘ + 1` – `⌘ + 5` |\n\n\u003e All shortcuts are fully configurable in **Settings**.\n\n---\n\n## Building From Source\n\nFlux is written in **SwiftUI** and uses a custom Python build pipeline that produces a universal binary and a distributable `.dmg` in a single command.\n\n### Prerequisites\n1.  **macOS 13.0 (Ventura) or later** — supports Apple Silicon \u0026 Intel\n2.  **Xcode Command Line Tools**: `xcode-select --install`\n3.  **Python 3**\n\n### Build \u0026 Install\n\n```bash\npython3 build_standalone.py\n```\n\nThis single command will:\n- Compile a **Universal Binary** for both Apple Silicon and Intel.\n- Generate high-resolution `.icns` icons at all required sizes.\n- Bundle the Finder extension (`FluxFinder.appex`).\n- Ad-hoc sign and package everything into `/Applications/Flux.app`.\n- Create `Flux_Universal.dmg` for distribution.\n- Launch the app automatically.\n\n---\n\n## Configuration\n\nAll data is stored locally in `~/.flux/`:\n\n| File | Contents |\n| :--- | :--- |\n| `settings.json` | Preferences, hotkeys, blacklist, language |\n| `clipboard.json` | Clipboard history |\n| `scratchpads.json` | Notes |\n| `translations.json` | Cached UI translations (offline-safe) |\n\n---\n\n## Security \u0026 Privacy\n\n*   **Local First**: No data ever leaves your machine, except for optional UI translation requests to the Google Translate API.\n*   **Keychain-Safe**: Clipboard content flagged as sensitive by password managers is automatically ignored and never stored.\n*   **App Blacklist**: Fine-grained control over which applications Flux monitors.\n*   **No Account Required**: Zero sign-up, zero telemetry, zero cloud dependency.\n\n---\n\n*Flux — Flow through your work.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpotatoinfinity%2Fflux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpotatoinfinity%2Fflux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpotatoinfinity%2Fflux/lists"}