A modern, powerful, and elegant desktop client for the Yeolpumta (YPT) study platform.
English • Português (Brasil) • 简体中文
Features • Installation • Architecture • Development • Legal Disclaimer • License
Desky was built to provide the ultimate desktop focus and productivity experience for students on Windows, macOS, and Linux. Featuring a dark AMOLED True Black interface inspired by Yeolpumta and optimized for high-resolution displays, it delivers all essential study capabilities natively on your PC.
- Standard & Pomodoro Modes: Customizable focus sessions, short breaks, and long breaks.
- Subject Management: Create, edit, archive, and customize subjects with color palettes.
- Manual Study Logs: Add past study sessions with instant time calculations.
- Offline Synchronization: Persistent request queue for uninterrupted tracking during connectivity drops.
- Process Monitoring: Automated detection and alerts for unauthorized distraction applications open during study.
- Strict Mode: Locks navigation to maintain deep focus.
- Floating Mini Player: Compact Always-on-Top timer overlay to monitor elapsed study time alongside study materials.
- Real-Time Attendance Feed: View active members studying live with real-time status updates and animated doll avatars.
- Live Study: Periodic webcam capture and secure upload for study verification.
- Group Chat: Rich messaging with emoji reactions, media attachments, and official YPT stickers.
- Social Nudges: Send "Shakes" to motivate group peers.
- Live Status Sync: Broadcast your current study subject, elapsed timer, and group activity directly to your Discord profile.
- Automatic Transitions: Seamlessly switches between "Studying", "Resting", and "Idle" status.
- Email & Password: Standard authentication with verification code password recovery.
- Google OAuth with PKCE: Native browser sign-in flow via local loopback port, ensuring secure authentication without embedded webview vulnerabilities.
- D-Day Countdowns: Visual countdown timers for exams, tests, and target milestones.
- Smart To-Do List: Priority-based tasks with due dates and recurrence rules.
- Weekly Timetable: Interactive weekly schedule grid organized by subject blocks.
- Multilevel Leaderboards: Real-time global, national, and category-based leaderboards (daily, weekly, monthly).
- Activity Heatmap Grid: GitHub-style annual matrix visualizing daily study intensity and consistency.
- Monthly Calendar: Detailed day-by-day study streaks and goal completion.
- Custom Decks: Organize study cards by subject and topic with SM-2 spaced repetition algorithm.
- Integrated PDF Reader: Open books and materials with page bookmarking and quick flashcard creation.
- Automated study session screen captures with built-in gallery viewer and video playback.
- Customizable doll avatars with outfits, accessories, and dynamic poses reactive to study state.
- In-app notification center for group announcements, member nudges, and system notices.
- Native support for 28 languages with instant runtime locale switching.
- Automatic release checks against GitHub Releases API with animated badge indicator in sidebar.
- Modal dialog with full changelog release notes and direct native installer download buttons.
Download the latest version directly from our official Releases Page.
| Platform | Package / Installer | Format | Installation Instructions |
|---|---|---|---|
| Windows | Desky-Windows-Installer-x64.exe |
Executable Setup | Run the .exe installer and follow the setup wizard. |
| Windows | Desky-Windows-x64.msix |
MSIX Package | Install directly with Windows App Installer / Microsoft Store format. |
| macOS | Desky-macOS-Installer.dmg |
Disk Image | Open .dmg and drag Desky.app to your Applications folder. |
| Linux (Debian/Ubuntu) | Desky-Linux-x64.deb |
Debian Package | Run sudo apt install ./Desky-Linux-x64.deb or sudo dpkg -i Desky-Linux-x64.deb. |
| Linux (Other Distros) | Desky-Linux-x64.tar.gz |
Portable Archive | Extract the archive and execute ./desky. |
The codebase follows Clean Architecture principles with clear layer separation:
lib/
├── core/ # Core services, networking, themes, constants & i18n
│ ├── api/ # HTTP client (Dio) and auth interceptors
│ ├── cdn/ # Dynamic CDN resolvers for avatars & assets
│ ├── constants/ # API endpoints and application defaults
│ ├── localization/ # Translation engine and fallback dictionaries (28 languages)
│ ├── oauth/ # Google OAuth PKCE and loopback server
│ ├── services/ # System services (Focus, Webcam, Updates, Window, Discord RPC)
│ └── theme/ # Dark theme palette, typography & styles
├── data/ # Data layer, DTOs and repositories
│ ├── models/ # Data models with JSON serialization
│ └── repositories/ # API communication and data access abstraction
├── features/ # Feature-first modular components
│ ├── auth/ # Email authentication & Google OAuth PKCE
│ ├── challenges/ # Study challenges and goals
│ ├── flashcards/ # Deck management & SM-2 algorithm
│ ├── groups/ # Study groups, attendance, chat & Live Study
│ ├── notifications/ # Notification center and alerts
│ ├── planner/ # Planner, To-Do list & timetable grid
│ ├── profile/ # User profile and account security
│ ├── ranks/ # Leaderboards, Heatmap matrix & calendar
│ ├── settings/ # Study preferences, language and legal dialogs
│ ├── smartbook/ # Built-in PDF reader and study material viewer
│ ├── store/ # Avatar inventory & store
│ ├── timelapse/ # Screen recording & timelapse playback
│ ├── timer/ # Main study timer, Pomodoro, Mini Player & subject tracker
│ └── updates/ # Release checker, changelog viewer & installer links
└── shared/ # Shared widgets (AppShell, SidebarNav, TitleBar, Avatars)
- Framework: Flutter Desktop (Dart 3.x)
- State Management: Flutter Riverpod
- Routing: GoRouter
- Networking: Dio
- Secure Storage: flutter_secure_storage & shared_preferences
- Charts & Animations: FL Chart & Lottie
- Desktop Window Control: window_manager
- Flutter SDK (
>= 3.0.0) - Windows: Visual Studio 2022 with "Desktop development with C++" workload.
- macOS: Xcode 15+ with command line tools.
- Linux: Build dependencies:
sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libsecret-1-dev libjsoncpp-dev
git clone https://github.com/huneyoliv/desky.git
cd deskyflutter pub get# Windows
flutter run -d windows
# macOS
flutter run -d macos
# Linux
flutter run -d linux# Run all automated tests
flutter test
# Static code analysis
flutter analyzeDesky is an independent, open-source third-party client and is not affiliated, endorsed, sponsored, or associated with Pallo Inc. or Yeolpumta (YPT). All trademarks belong to their respective owners.
This project is licensed under the MIT License.