Orchestrana is a macOS productivity app that connects focus sessions, Tasks, Reminders, and Calendar into a single workflow.
It is not just a timer — it links tasks, time, and focus, adapting to task-driven, time-blocking, or flow-based work styles. Orchestrana is built as a unified time system rather than a rigid productivity method, with a macOS-inspired glass / liquid glass UI.
If the app still ask for calendar & reminders permissions after you activate, please quit and restart the app
Explore the project website for design philosophies, documentation, and downloads:
👉 https://orchestrana.app
Orchestrana is now available on the Mac App Store.
👉 Download Orchestrana:
https://apps.apple.com/app/orchestrana/id6758972580
Download the latest release from GitHub and run the app.
- Gatekeeper warning: macOS may warn that the app is from an unidentified developer. This is expected while the project awaits Apple Developer Program approval.
- Bypass Gatekeeper safely: follow the step‑by‑step guide in
docs/Gatekeeper.mdto open the downloaded app without compromising security.
The App Store build is the recommended signed distribution.
- ⏱️ Customizable work, short break, and long break durations
- 🔁 Long-break interval configuration (e.g. every 4 sessions)
- ⚡ Presets for quick switching (25/5, 50/10, 90/15, Custom)
▶️ Start / Pause / Resume / Reset with clear state feedback- ⏳ Dedicated countdown timer mode
- ✅ Tasks with optional Reminders integration and bidirectional sync foundations
- 📅 Calendar views (Day / Week / Month) as a visual layer for planning
- 🔔 Session-end pop-up reminder with optional sound
- 📊 Daily productivity summary (focus time, sessions, breaks)
- 💾 Automatic saving of daily stats
- 🎧 Ambient sound player (white noise, brown noise, rain, wind)
- 🎵 Simple music status support (Apple Music / Spotify)
- 🪟 Glass-panel UI with background blur and depth
- 🌙 macOS dark mode support
- 💻 Real time menubar support on MacBooks
Orchestrana is designed as a unified time system — not just a timer. It brings together focus sessions, tasks, reminders, and calendar blocks into one single workflow, so planning and execution live in the same place.
Instead of forcing a rigid productivity method, Orchestrana adapts to how you actually work — whether that’s time-blocking, task-driven planning, or flow-based focus.
If you prefer not to build from source, download the binary from the latest release (see “Try it now” above). On first launch, macOS may block the app; use the Gatekeeper guide linked above.
Requires Xcode on macOS 14.6 or later. Clone this repository, open the project in Xcode, and build/run as usual.
Requirements:
- Firebase iOS SDK 12.9.0 or later (Swift Package Manager should automatically download gRPC, GoogleUtilities, etc. for you)
- Xcode on macOS 14.6 or later
This project uses Swift Package Manager to manage dependencies.
The current version is fully native Swift; legacy Tauri/Svelte/Python versions are archived.
⚠️ Important
- The included GoogleService-Info.plist is for this project only
- It is not intended for reuse, modification, or external environments
🚫 Do NOT
- Do not use this configuration for your own Firebase projects
- Do not modify or overwrite this file in commits
- Do not rely on it outside of this repository
✅ If you want to use your own Firebase project
- Create your own Firebase project
- Download your own GoogleService-Info.plist
- Replace the file locally only
- Add it to your local ignore if needed
See Example:
GoogleService-Info.plist.sampleLegal Notice
The Firebase configuration contained in this repository is the property of the project owner and is provided strictly for use within this project only.
You are not permitted to:
- Use this configuration in any other application or project
- Send requests to the associated Firebase project outside of this application
- Attempt to access, exploit, or interfere with the backend services
- Any types of abuses
Any unauthorized use may result in access restrictions and may be subject to further action.
For full details on updates, see the release notes on the App Store.
👉 App Store release notes are the source for current version changes and updates.
- Will receive more updates
- Changes may occur without notice
- Feedback, PR, and issue reports are welcome
- Current public distribution is through the App Store
AI-powered features are now available in Orchestrana.
Availability depends on the current app version, account state, subscription tier, regional availability, and usage limits. Some AI features require Plus or Pro because they use managed backend services and external AI providers.
The current UI uses a structured glass tile system inspired by macOS 26 (liquid glass).
The goal of upcoming versions is to transition toward a softer, macOS-inspired liquid glass look — with more subtle contrast, improved typography, and refined panel depth.
- Stable for daily use
- Design iterations are ongoing
- New features are in development
🚧 Distribution Status
Orchestrana is currently under active development and available on the App Store.
🚀 App Store Download Available
The current signed Mac build is available through Apple's App Store.
👉 Download Orchestrana:
https://apps.apple.com/app/orchestrana/id6758972580Thank you for your interest and support ❤️
Planned for future versions:
- 🧠 Personal Knowledge Base and AI-ready context
- 📝 Lightweight notes connected to focus, tasks, and plans
- 🧩 AI Jam for structured idea generation and transformation
- 📦 Exportable context packs for external AI tools
- 🎨 More macOS-style liquid glass theme refinements
- 🪄 Smoother button & timer animations
- 💡 Better logic
- 🔔 Advanced reminder scheduling & customization
- ⌨️ More features
- 🛎️ Issue requirements
See: Docs/Public_Roadmap.md, Docs/Future_Pro_Plan.md, and Docs/Roadmap_1.0-2.0.md
Orchestrana currently uses three public plan levels:
- Free — Included
- Plus — $4.99/month or $39.99/year
- Pro — $7.99/month or $69.99/year
See the public comparison page for the full feature breakdown: https://orchestrana.app/comparison
Prices are shown in USD. App Store regional pricing, taxes, offers, and availability may vary. The App Store and current app build are the source of truth for active subscription terms.
You’re welcome to help improve:
- 🎨 UI & visual refinement (macOS-style liquid glass direction)
- 🧩 Session logic & customization options
- 🔔 In-app reminder & notification
- 🧪 Bug fixes and stability improvements
- 📝 Documentation
- ✅ Anything else
If you want to:
- propose a feature
- discuss UI / UX direction
- any other things about this project
You can open a Discussion or Issue instead of a PR.
Constructive feedback is especially welcome during the current 1.x.x integration and planning phase.
Orchestrana has gone through multiple architectural stages during its development. All previous implementations are preserved for reference only and are no longer part of the active product direction.
Legacy see: https://github.com/T-1234567890/Pomodoro-legacy
Status
- ❌ Deprecated
- ❌ Prototype only
- ❌ No longer representative of the project
- ❌ No longer maintained
The current mainline version of Orchestrana is fully native Swift (macOS).
Details
This version introduced a modern desktop architecture before the move to native Swift.
Stack
- Frontend: Svelte
- Desktop shell: Tauri
- Backend: Python (Pomodoro engine)
- IPC: JSON-based bridge between frontend and backend
Reason for deprecation While functional, this architecture:
- Added unnecessary complexity on macOS
- Limited deep system integration
- Did not fully match macOS performance and UX expectations
The project has since migrated to native Swift for clarity, performance, and long-term maintainability.
This was the original prototype used during the earliest stages of development.
Stack
- Python
- Tkinter UI
- Single-process desktop app
- Future planning:
docs/Future_Pro_Plan.md - Development roadmap:
docs/Roadmap_1.0-2.0.md - FAQ & design decisions:
docs/FAQ.md - Gatekeeper & installation notes:
docs/Gatekeeper.md
The Orchestrana client is open source under the repository license.
Orchestrana is also a commercial product with existing paid plans for hosted services and higher-cost features such as managed AI, subscription-gated capabilities, and backend-supported functionality. The open-source client does not mean every hosted service or production feature is free.
Details: Docs/Future_Pro_Plan.md is a legacy planning document and may be outdated compared with the current product and App Store configuration.
This project is supported by partners who help keep development sustainable.
VPS.Town provides infrastructure support for testing and cloud experimentation.
| Category | Partner |
|---|---|
| Infrastructure Sponsor | VPS.Town |
| AI Partner | Available |
| Community Partner | Available |
| Tools / Integration Partner | Available |
| Other | Available |
Interested in sponsoring or partnering with Orchestrana? Contact us below.
This project is under active development and some features or UI elements may change over time.
If you encounter issues or have suggestions, feel free to open an issue or pull request.
Orchestrana™ is a commercial product. While this client is open-source, the following terms apply:
- Client License: The code in this repository is licensed under the MIT License.
- Proprietary Backend: The server-side infrastructure, database, and production APIs are closed-source. Access to this repository does not grant permission to interact with, access, or test any production systems.
- Contributions: By submitting a Pull Request or any kind of contributing, you agree to grant the project owner a perpetual, worldwide, non-exclusive license to use your contributions commercially.
Official legal and policy documents for the app and website.
Orchestrana™ is a trademark of Shenzhen Tushengjin Commercial Services Co., Ltd.
Policies & Legal
Repository Additional Terms
- 📧 Support: support@orchestrana.app
- 📧 General: hello@orchestrana.app
- 🌐 Website: https://orchestrana.app
- 💬 Issues / PRs / Discussions are welcome
We’re happy to hear feedback, bug reports, and feature ideas.