Yuki OS - Browser Desktop Environment

Try it now: yukios.pages.dev · yukios.vercel.app · yukios.netlify.app · yukiwebos.github.io

A browser-based desktop environment running in a single web page, combining windowed multitasking, persistent storage, emulators, tools, and a large collection of applications and games.

Yuki OS turns a browser tab into a working desktop-style space with draggable windows, multitasking, file handling, emulators, productivity tools, and interactive apps. Everything runs locally in the browser with persistent storage and session state.

It supports running Flash content, DOS programs, console emulation, WebAssembly apps, and standard web applications side by side.

It's built entirely in vanilla JS/TypeScript (with some libraries, of course!)

---

✨ Desktop Experience

• Draggable, resizable, minimizable, maximizable windows
• Window snapping (half screen, quarter screen, fullscreen)
• Multiple workspaces with independent layouts
• Window switching and focus cycling (with alt+Q)
• Live taskbar peeking support on hover
• Window context menus (snap, move, pin, workspace transfer)
• Window header menus for quick actions
• Window icons in title bar
• Taskbar positioned on any edge of the screen
• Taskbar drag to reorder and click to minimize/restore
• System tray with background-running apps
• Tray controls and quick actions
• Desktop shortcuts with drag-and-drop support
• Desktop stretch scroll prevention toggle
• Alt+Right-Click window resize
• Window animation system with 35+ effects
• Cursor launch effect like in kde plasma
• Automatically saves and restores open apps, window positions and sizes, workspace assignments, scroll positions, window states (minimized, fullscreen, snapped), focus order

---

🧭 Navigation & UI

• Taskbar with pinned and running apps
• Start menu for launching and managing apps with keyboard navigation
• Start menu alphabetical grouping with section headers
• Start menu keybinds (Space, Tab, Ctrl)
• Desktop icon system with persistent shortcuts and image thumbnails
• Notification center with grouped messages
• Do Not Disturb mode
• Notification positioning controls
• Context menus across desktop and apps
• Animated UI with adaptive transparency effects
• Keyboard shortcuts app for global hotkeys

Key Global Shortcuts:

• Ctrl+K / Ctrl+P / F1 - Open command palette
• Ctrl+D - Show/hide desktop
• Alt+Q - Cycle through windows
• Ctrl+Shift+S - Full screenshot
• Ctrl+Alt+S - Area screenshot
• Ctrl+Shift+R - Screen recording

Command Palette Features:

• Search apps, files, and system commands
• Quick actions: wallpaper, themes, DND, mute, workspace switching
• Terminal commands (prefix with >)
• Built-in calculator and unit converter
• Screenshot and screen recording controls

---

📁 Files & Storage

• Persistent browser storage using IndexedDB

• File explorer with thumbnails and previews

• Drag-and-drop file operations from host OS

• Context menu to open images in Paint

• File properties dialog with rename support

• Create, move, rename, delete, and organize files

• Drag-select multiple files with selection box

• Trash bin with restore functionality

• Archive support: .zip, .gz, .tar, .tar.gz, .tgz, .tar.xz, .7z, .bz2, .tar.bz2, .xz, .rar (create: .zip, .7z, .tar, .tar.gz, .tar.bz2, .gz, .bz2 with password-protected ZIP support)

• Bulk file actions, download file support

• File-based actions like setting wallpapers and conversions

• HTML file rendering support

• Dynamic favicon updates based on current app

📦 Applications

80+ built-in applications and direct launch via URL parameters (?app= and ?game=)

---

⚙️ System Features

• Cross-app event communication
• Notification system with app icons and actions
• Per-app audio mixer with live visualizer and volume controls
• Achievement tracking and usage milestones
• Setup flow for first-time configuration
• Theme system with 40 presets and custom theme support, light/dark and transparency modes
• Wallpaper customization with animated wallpaper and Vanta.js support
• PWA install and offline caching support
• User accounts with multi-profile support
• Lock screen and session management
• Power management modes (Turbo, Balanced, Quality)
• Custom cursor support (with miku by default)
• Import/export system for backup and migration
• Transparent UI toggle
• Clock system is using OffscreenCanvas rendering and lightweight NTP offset sync with js worker

---

💾 Persistence

• Session persistence for windows and workspaces
• User profiles with settings and personalization
• Backup and restore of system state

📦 Built-in Applications

🧠 Productivity & Development

• Explorer
• Terminal (Unix-like commands with tab completion, history, pipelines, and glob patterns)
• Notepad
• Markdown Editor
• Yuki Code
• VS Code
• Settings
• Task Manager
• Installed Apps
• Calculator
• About
• Shortcuts
• Setup Wizard
• What's New
• Achievements
• Profile Customizer
• Yuki AI Assistant
• Storage Editor
• Yuki Convert
• Clipboard Manager
• Categories
• Emoji Selector
• YukiDevTools (IT - TOOLS)
• Dev Tools (Eruda)
• Weather
• News
• Yuki OS Guide
• Display Performance
• Network Tray
• Maps
• Virtual Machine Manager
• Accounts

🎨 Media & Creative Tools

• Paint
• Mini Paint
• Photopea
• LibreSprite
• Pixlr
• Camera App
• Media Viewer
• Office Viewer
• Evil Spotify
• Yuki Blender
• YouTube Utilities
• Rhythms (Cavalier-like audio visualizer)
• Screenshot (page capture, area selection, screen recording)
• Color Picker (screen color sampling with magnified preview)

🌐 Browser & Internet

• WebTorrent Client
• Yuki Browser
• Tor Connection Manager (WebAssembly Tor with Snowflake bridge)
• VNC Client (remote desktop via VNC with saved profiles and clipboard sync)
• Steam-like game launcher

🔒 Tor Anonymous Browsing

Browse anonymously through the Tor network directly from your browser, using a WASM-based Tor client with Snowflake transport.

Web Apps

• Discord
• Spotify
• TikTok
• ChatGPT
• Grok
• Email providers (Gmail, Outlook, ProtonMail)
• DeepSeek
• Twitter/X
• Instagram
• Pinterest
• GitHub GitLab CodePen Replit
• Twitch
• SoundCloud
• Notion
• Figma
• Canva
• Google Docs
• kiwiIRC
• GeForce Now
• Scramjet Browser

🎮 Games & Emulation Tools

• Yuki Emulator(EmulatorJS)
• Ruffle (Flash)
• JsDos (DOS)
• Virtual 86 (x86)
• Azahar (3DS Emulator)

🎮 Steam-like In-Game Overlay

Shift+Tab overlay with draggable, resizable panels for any running game:

• Playtime overview (total, 2-week, and current session)
• Achievement browser with All/Unlocked/Locked filters
• Friends panel and persistent per-game sticky notes
• In-overlay web browser and Scramjet proxy panel
• Screenshot capture, gallery view, and video recording
• Performance monitor for fps/frame
• Overlay settings (toggle, perf monitor, rebindable shortcut key)

---

🔌 Extensibility

Extensible app platform with background apps, shared events, persistent state, and windowed web app integration. Custom App Creator

---

🛠 Build & Deployment

pnpm run dev
pnpm run build:dev
pnpm run build
pnpm run preview

Single-file bundling for easy deployment.

---

🤝 Contributing

We welcome contributions! Whether you want to add a new app, fix a bug, or improve documentation, we'd love your help.

For detailed information on:

• Creating new applications
• Using the OS API
• Styling guidelines
• Code quality standards
• Build and deployment processes

See the Development Guide.

---

🛠 Tech Stack

• BrowserFS
• interact.js
• Ruffle
• EmulatorJS
• Monaco Editor
• three.js
• PDF.js
• JSZip
• fflate
• archive-wasm (Spacedrive)
• 7z-wasm (use-strict)
• Handsontable
• Mammoth.js
• Font Awesome
• emoji-mart
• Vanta.js
• WebTorrent
• Eruda
• Scramjet / BareMux / Epoxy Transport
• webtor-rs WASM Tor client (Arti + Snowflake)

Tooling stack

• Vite
• Typescript
• Eslint
• Prettier
• viteSingleFile