{"id":16610201,"url":"https://github.com/blackboardsh/electrobun","last_synced_at":"2026-05-04T06:06:35.651Z","repository":{"id":224866589,"uuid":"764419211","full_name":"blackboardsh/electrobun","owner":"blackboardsh","description":"Build ultra fast, tiny, and cross-platform desktop apps with Typescript.","archived":false,"fork":false,"pushed_at":"2026-04-26T21:51:00.000Z","size":142402,"stargazers_count":11470,"open_issues_count":179,"forks_count":290,"subscribers_count":45,"default_branch":"main","last_synced_at":"2026-04-26T23:20:25.982Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://blackboard.sh/electrobun","language":"TypeScript","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/blackboardsh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":"YoavCodes"}},"created_at":"2024-02-28T03:18:15.000Z","updated_at":"2026-04-26T23:12:51.000Z","dependencies_parsed_at":"2024-10-23T17:54:48.395Z","dependency_job_id":"8063079b-faf8-4133-9e95-af2529e2bc02","html_url":"https://github.com/blackboardsh/electrobun","commit_stats":null,"previous_names":["blackboardsh/electrobun"],"tags_count":338,"template":false,"template_full_name":null,"purl":"pkg:github/blackboardsh/electrobun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboardsh%2Felectrobun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboardsh%2Felectrobun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboardsh%2Felectrobun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboardsh%2Felectrobun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blackboardsh","download_url":"https://codeload.github.com/blackboardsh/electrobun/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboardsh%2Felectrobun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32596533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"online","status_checked_at":"2026-05-04T02:00:06.625Z","response_time":58,"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":"2024-10-12T01:29:32.437Z","updated_at":"2026-05-04T06:06:35.641Z","avatar_url":"https://github.com/blackboardsh.png","language":"TypeScript","funding_links":["https://github.com/sponsors/YoavCodes"],"categories":["TypeScript","others","Repos","🌐 Web Development - Frontend","Uncategorized","\u003ca name=\"TypeScript\"\u003e\u003c/a\u003eTypeScript","C++","Framework"],"sub_categories":["Uncategorized"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://electrobun.dev\"\u003e\u003cimg src=\"https://github.com/blackboardsh/electrobun/assets/75102186/8799b522-0507-45e9-86e3-c3cfded1aa7c\" alt=\"Logo\" height=170\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eElectrobun\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n  Get started with a template \u003cbr /\u003e\n  \u003ccode\u003e\u003cstrong\u003enpx electrobun init\u003c/strong\u003e\u003c/code\u003e   \n\u003c/div\u003e\n\n\n\n## What is Electrobun?\n\nElectrobun aims to be a complete **solution-in-a-box** for building, updating, and shipping ultra fast, tiny, and cross-platform desktop applications written in Typescript.\nUnder the hood it uses \u003ca href=\"https://bun.sh\"\u003ebun\u003c/a\u003e to execute the main process and to bundle webview typescript, and has native bindings written in Objc, C++, and several core parts written in \u003ca href=\"https://ziglang.org/\"\u003ezig\u003c/a\u003e.\n\nVisit \u003ca href=\"https://docs.electrobunny.ai/electrobun/\"\u003ehttps://docs.electrobunny.ai/electrobun/\u003c/a\u003e to see api documentation, guides, and more.\n\nYou use it via npm.\n\nDon't miss our:\n- self-extracting bundles that use ZSTD compression for more compact distributables as small as 16MB\n- zig optimized BSDIFF implementation that lets you ship tiny app updates as small as 4KB\n- `bundleCEF` flag to bundle and pin Chromium for those that want that tradeoff of consistency over file size\n- `bundleWGPU` that lets you use Bun Typescript -\u003e WGPU to control a native GPU surface without a webview\n- Our Three.js and Babylon.js adapters that work right in Bun\n- Our `\u003celectrobun-webview\u003e` and `\u003celectrobun-wpgu\u003e` html elements that let you composit proper OOPIFs and native GPU surfaces into your UIs\n- so much more.\n\n**Project Goals**\n\n- Write typescript for the main process and webviews without having to think about it.\n- Isolation between main and webview processes with fast, typed, easy to implement RPC between them.\n- Small self-extracting app bundles ~14MB (when using system webview, most of this is the bun runtime)\n- Even smaller app updates as small as 4KB (using bsdiff it only downloads tiny patches between versions)\n- Provide everything you need in one tightly integrated workflow to start writing code in 5 minutes and distribute in 10.\n\n## Apps Built with Electrobun\n- [24agents](https://github.com/jhsu/24agents) - Hyperprompter\n- [act-track-ai](https://github.com/IrdanGu/act-track-ai) - personal desktop productivity tracker\n- [Agents Council](https://github.com/MrLesk/agents-council) - agent-to-agent MCP communication tool for feedback requests\n- [ai-wrapped](https://github.com/gulivan/ai-wrapped) - Wrapped-style desktop dashboard for your AI coding agent activity\n- [Audio TTS](https://github.com/blackboardsh/audio-tts) - desktop text-to-speech app using Qwen3-TTS for voice design, cloning, and generation\n- [aueio-player-desktop](https://github.com/tuomashatakka/aueio-player-desktop) - beautiful, minimal cross-platform audio player\n- [bestdiff](https://github.com/tesmond/bestdiff) - a git diff checker with curved connectors\n- [BuddyWriter](https://github.com/OxFrancesco/BuddyWriter) - BuddyWriter desktop and mobile apps\n- [burns](https://github.com/l3wi/burns) - a Smithers manager\n- [cbx-tool](https://github.com/jebin2/cbx-tool) - desktop app for reading and editing comic book archives (.cbz/.cbr)\n- [Co(lab)](https://blackboard.sh/colab/) - a hybrid web browser + code editor for deep work\n- [codlogs](https://github.com/tobitege/codlogs) - search and export local Codex sessions via CLI or desktop app\n- [Codex Agents Composer](https://github.com/MrLesk/codex-agents-composer) - desktop app for managing your Codex agents and their skills\n- [codex-devtools](https://github.com/gulivan/codex-devtools) - desktop inspector for Codex session data; browse conversations, search messages, and analyze agent activity\n- [Deskdown](https://github.com/guarana-studio/deskdown) - transform any web address into a desktop app in under 20 seconds\n- [Dictate](https://github.com/siddhantparadox/dictate) - Windows dictation app with local and BYOK cloud transcription\n- [dev-3.0](https://github.com/h0x91b/dev-3.0) - helps you not get lost while managing multiple AI agents across projects\n- [DOOM](https://github.com/blackboardsh/electrobun-doom) - DOOM implemented in 2 ways: bun -\u003e (c doom -\u003e bundled wgpu) and (full ts port bun -\u003e bundled wgpu)\n- [dotlock](https://github.com/tsconfigdotjson/dotlock) - macOS desktop app for managing `.env` files across your projects\n- [electrobun-pdf](https://github.com/GijungKim/electrobun-pdf) - local-first PDF \u0026 DOCX editor for opening, annotating, and exporting documents without leaving your machine\n- [electrobun-rms](https://github.com/khanhthanhdev/electrobun-rms) - fast Electrobun desktop app template with React, Tailwind CSS, and Vite\n- [golb](https://github.com/chrisdadev13/golb) - desktop AI coding workspace built with React, Vite, and Tailwind\n- [GOG Achievements GUI](https://github.com/timendum/gog-achievements-gui) - desktop app for managing GOG achievements\n- [groov](https://github.com/laurenzcodes/groov) - desktop audio deck monitor\n- [Guerilla Glass](https://github.com/okikeSolutions/guerillaglass) - open-source cross-platform creator studio for fast Record -\u003e Edit -\u003e Deliver workflows\n- [Marginalia](https://github.com/lars-hoeijmans/Marginalia) - a simple note taking app\n- [MarkBun](https://github.com/xiaochong/markbun) - fast, beautiful, Typora-like markdown desktop editor\n- [md-browse](https://github.com/needle-tools/md-browse) - a markdown-first browser that converts web pages to clean markdown\n- [Patchline](https://github.com/adwaithks/Patchline) - lightweight desktop Git client for reading patches and line diffs, then staging and committing changes\n- [peekachu](https://github.com/needle-tools/peekachu) - password manager for AIs; store secrets in your OS keychain and scrub output so AI assistants never see actual values\n- [PiBun](https://github.com/khairold/pibun) - desktop GUI for the Pi coding agent with chat, terminal, git integration, and plugin system\n- [PLEXI](https://github.com/ianjamesburke/PLEXI) - a multi-dimensional terminal multiplexer for the agentic era\n- [Prometheus](https://github.com/opensourcectl/prometheus) - desktop utility toolbox for file cleanup, document manipulation, and image processing\n- [Quiver](https://ataraxy-labs.github.io/quiver/) - desktop app for GitHub PR reviews, merge conflict resolution, and AI commit messages\n- [remotecode.io](https://github.com/samuelfaj/remotecode.io) - continue local AI coding sessions (Claude Code or Codex) from your mobile device\n- [sirene](https://github.com/KevinBonnoron/sirene) - self-hosted multi-backend text-to-speech platform with voice cloning\n- [StoryForge](https://github.com/vrrdnt/StoryForge) - desktop app for Vintage Story players to switch between game versions, modpacks, servers, and accounts\n- [Tensamin Client](https://github.com/Tensamin/Client) - web, desktop, and mobile app for accessing Tensamin\n- [tokenpass-desktop](https://github.com/b-open-io/tokenpass-desktop) - desktop app that runs the Sigma Identity stack locally for Bitcoin-backed authentication\n- [typsmthng-desktop](https://github.com/aaditagrawal/typsmthng-desktop) - experimental desktop typing application\n- [VibesOS](https://github.com/popmechanic/VibesOS) - A GUI for Claude Code that makes it easy to vibe code simple, un-hackable apps\n- [VoiceVault](https://github.com/PJH720/VoiceVault) - AI-powered voice recorder with transcription, summarization, and RAG search\n- [warren](https://github.com/Loa212/warren) - open-source, peer-to-peer terminal mesh for accessing your machines from any device without SSH keys or config files\n- [whatsapp-reminder](https://github.com/FatahChan/whatsapp-reminder) - managed scheduled WhatsApp messages\n\n### Video Demos\n\n[![Audio TTS Demo](https://img.youtube.com/vi/Z4dNK1d6l6E/maxresdefault.jpg)](https://www.youtube.com/watch?v=Z4dNK1d6l6E)\n\n[![Co(lab) Demo](https://img.youtube.com/vi/WWTCqGmE86w/maxresdefault.jpg)](https://www.youtube.com/watch?v=WWTCqGmE86w)\n\n[![DOOM Demo](https://github.com/user-attachments/assets/6cc5f04a-6d97-4010-b65f-3f282d32590c)](https://x.com/YoavCodes/status/2028499038148903239?s=20)\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=blackboardsh/electrobun\u0026type=date\u0026legend=top-left\u0026cache=3)](https://www.star-history.com/#blackboardsh/electrobun\u0026type=date\u0026legend=top-left)\n\n## Contributing\nElectrobun is one piece of a vision I'm building. I'm optimizing for focus and execution. Issues and PRs can be used to share ideas, but there should be no expectation that I will review, respond to, or merge them.\n\nWays to get involved:\n\n- Read the [Contribution guidelines](./CONTRIBUTING.md)\n- Follow us on X for updates \u003ca href=\"https://twitter.com/BlackboardTech\"\u003e@BlackboardTech\u003c/a\u003e and \u003ca href=\"https://twitter.com/YoavCodes\"\u003e@YoavCodes\u003c/a\u003e or on bluesky \u003ca href=\"https://bsky.app/profile/yoav.codes\"\u003e@yoav.codes\u003c/a\u003e\n- Join the conversation on \u003ca href=\"https://discord.gg/ueKE4tjaCE\"\u003eDiscord\u003c/a\u003e\n- Create and participate in Github issues and discussions\n- Let me know what you're building with Electrobun\n\n## Development Setup\nBuilding apps with Electrobun is as easy as updating your package.json dependencies with `npm add electrobun` or try one of our templates via `npx electrobun init`.\n\n**This section is for building Electrobun from source locally in order to contribute fixes to it.**\n\n### Prerequisites\n\n**macOS:**\n- Xcode command line tools\n- cmake (install via homebrew: `brew install cmake`)\n\n**Windows:**\n- Visual Studio Build Tools or Visual Studio with C++ development tools\n- cmake\n\n**Linux:**\n- build-essential package\n- cmake\n- webkit2gtk and GTK development packages\n\nOn Ubuntu/Debian based distros: `sudo apt install build-essential cmake pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev`\n\n### First-time Setup\n\n```bash\ngit clone --recurse-submodules https://github.com/blackboardsh/electrobun.git\ncd electrobun/package\nbun install\nbun dev:clean\n```\n\n### Development Workflow\n\n```bash\n# All commands are run from the /package directory\ncd electrobun/package\n\n# After making changes to source code\nbun dev\n\n# If you only changed kitchen sink code (not electrobun source)\nbun dev:rerun\n\n# If you need a completely fresh start\nbun dev:clean\n```\n\n### Additional Commands\n\nAll commands are run from the `/package` directory:\n\n- `bun dev:canary` - Build and run kitchen sink in canary mode\n- `bun build:dev` - Build electrobun in development mode\n- `bun build:release` - Build electrobun in release mode\n\n### Debugging\n\n**macOS:** Use `lldb \u003cpath-to-bundle\u003e/Contents/MacOS/launcher` and then `run` to debug release builds\n\n## Platform Support\n\n| OS | Status |\n|---|---|\n| macOS 14+ | Official |\n| Windows 11+ | Official |\n| Ubuntu 22.04+ | Official |\n| Other Linux distros (gtk3, webkit2gtk-4.1) | Community |\n| Raspberry Pi | Unofficial fork: [kortexa-ai/electrobun (linux-wpe)](https://github.com/kortexa-ai/electrobun/tree/kortexa/linux-wpe) — follow the author [@francip](https://x.com/francip/status/2050149256053539059?s=20) |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackboardsh%2Felectrobun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackboardsh%2Felectrobun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackboardsh%2Felectrobun/lists"}