Skip to content
JNTMTMTMPublic

About

eIsland - A sleek, Apple Dynamic Island inspired floating widget for Windows, built with Electron and Tauri.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

358 stars

Watchers

0 watching

Forks

Latest commit

 

History

4,268 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
eIsland

eIsland — A Dynamic Island for your Windows desktop

Release Platform License

Download · Website · Developer docs · Changelog

Note

eIsland is open source under GPLv3 with additional terms. See License before redistributing.

One island, four states

eIsland idle, hover, expanded and max expand states

Idle → Hover → Expanded → Max Expand
Rest the cursor on the island to peek, scroll the wheel to go deeper.

Gallery

Lyrics, quick tools and weather inside the pill

Lyrics & hover views

Music player with synced lyrics

Music & lyrics

AI agent chat

AI agent

Todo list

Todo

Countdown events on a NASA wallpaper

Countdown & wallpapers

Wallpaper market

Wallpaper market

Graphing calculator

Graphing calculator

World clock

World clock

Toolbox

Toolbox

2048 mini game

Mini games

Settings quick navigation

Settings

Calendar in light theme

Light theme

Standalone window with URL favorites

Standalone window

Getting started

Use a published Windows x64 installer from Releases, or build the native installer below. Native packages are named eIsland_<version>_x64-setup.exe. eIsland runs on Windows 10 22H2 or later (x64).

Build from source

Requirements: Node.js 24.22.1 (see .nvmrc), Rust with the Windows MSVC toolchain, Visual Studio C++ build tools, and WebView2.

git clone https://github.com/JNTMTMTM/eIsland.git
cd eIsland
npm ci --ignore-scripts
npm ci --prefix cli --ignore-scripts
npm ci --prefix temp/app --ignore-scripts
npm run plugins:build # prepare FFmpeg and ffprobe
npm run dev                 # start Tauri with hot reload
npm run package             # Tauri NSIS and same-version migration adapter

The desktop runtime, native services, tests and CI use Tauri. Packaging requires an updater signing identity; see release commands and upgrade compatibility and the refactor verification and coverage audit.

The release version starts at 27.0.2. Keep the root package.json, Tauri configuration and Cargo version in sync; packaging automatically synchronizes the migration adapter version. Configure the production Tauri signing identity, COS/OSS/R2 credentials and ESA cache settings in the root .env, then run these commands from the repository root:

npm run package                         # build both applications without uploading
npm run release:upload-only -- --dry-run # inspect the paired release plan
npm run release:upload-only              # upload both applications and their feeds
# Or build and upload both in one command:
npm run release

Electron uses latest.yml to download eIsland-<version>-Setup.exe, the migration adapter. Tauri and the adapter use tauri-latest.yml to download eIsland_<version>_x64-setup.exe; this feed contains official Tauri JSON despite its .yml filename. Existing JSON feed URLs remain available. All installers, signatures and blockmaps are uploaded before the feeds; the Electron feed is updated last.

The default local upload publishes only to COS, OSS, optional MinIO and ESA, and never touches GitHub. GitHub publication is part of the --r2-only CI path: enable EISLAND_GITHUB_RELEASE_UPLOAD=1, set GITHUB_REPOSITORY=JNTMTMTM/eIsland and EISLAND_GITHUB_RELEASE_TAG=v<version>, and authenticate gh. Create one published stable Release with that tag before uploading. Both applications and both feeds are attached to that same Release. Every upload refuses to replace a feed that advertises a newer version, and restores the previous feeds if any feed write fails.

Pushing a v<version> tag only builds both applications as review artifacts. To publish to R2 and GitHub, run the release workflow manually on that tag with publish enabled. Release builds must use a commit reachable from main, and the signing and storage secrets belong to the protected release environment.

npm run check runs lint, type checks and tests. The developer docs cover the architecture, IPC APIs and plugins.

Built with

Tauri React TypeScript Vite Zustand Tailwind CSS i18next Vitest Playwright

Community

Bug reports and feature requests are welcome in Issues. Please follow the Code of Conduct.

Credits

Icons come from iconfont. The built-in wallpapers are Artemis II mission photos from NASA:

Wallpaper File Capture device Source
Spaceship Earth art002e008487-orig.jpg iPhone 17 Pro Max images.nasa.gov
A Crescent Earth art002e004441-orig.jpg NIKON Z9 35mm f/2 images.nasa.gov
Thinking of You, Earth art002e008486-orig.jpg iPhone 17 Pro Max images.nasa.gov

NASA images are used under NASA's image usage policy and do not imply NASA endorsement of this project. More Artemis II images: images.nasa.gov · Artemis II mobile wallpapers.

The music, todos, chat and wallpaper market listings shown in the screenshots are demo data.

Legal

License

This project is released under GNU General Public License v3.0 (GPLv3) or later (GPL-3.0-or-later).

Under GPLv3 Section 7(b), limited additional terms apply: the following author attributions must be retained in all copies, modified versions, and any Appropriate Legal Notices displayed by the program:

For full terms (including the standard GPLv3 text and additional clauses), see the LICENSE file in the repository root.

About

eIsland - A sleek, Apple Dynamic Island inspired floating widget for Windows, built with Electron and Tauri.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

358 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages