QuickNote for macOS

繁體中文

A simple, fast, and lightweight note-taking application for macOS, designed for quick access and ease of use.

---

✨ QuickNote in Action

Light Theme

Dark Theme

Settings Panel (light)

Settings Panel (Dark)

---

🚀 Key Features

QuickNote isn't just another text editor. It's meticulously crafted to be an extension of your mind, ready to capture thoughts frictionlessly and boost your productivity.

Core Experience & Performance

• ⚡️ Instant Global Access: Summon a new note or toggle your workspace from anywhere in your OS with customizable global hotkeys. Capture ideas the moment they strike, without ever leaving your current context.
• 💨 Native Performance, Feather-light Footprint: Built with a Rust backend and a Tauri core, QuickNote launches instantly and runs with minimal CPU and memory usage. Experience native speed and responsiveness that web-based apps can't match.
• 🧠 Focus-Aware Activation: When you summon QuickNote via a shortcut, it intelligently brings itself to the foreground and stays on top temporarily, ensuring you can start typing immediately without the window disappearing.

Intuitive & Modern Interface

• 🗂️ Advanced Tab Management: Organize your thoughts with a powerful tabbed interface. Effortlessly drag-and-drop to reorder tabs, double-click to rename, and see unsaved changes at a glance with a visual indicator (•).
• ✍️ Minimalist yet Powerful Editor: A clean, distraction-free writing environment featuring essential tools like line numbers and proper tab indentation support, helping you focus on what matters: your content.
• 🌓 Dynamic Theming: Seamlessly switch between a beautiful Light and a comfortable Dark theme. Your choice is saved and applied instantly, adapting the entire UI to your preference.
• 🖼️ Sleek Frameless Design (macOS): Enjoy a modern, unified aesthetic on macOS with a custom frameless window and fully functional, integrated "traffic light" controls for a truly native feel.
• 📂 Drag & Drop to Open: Simply drag files from your desktop or file explorer and drop them onto the QuickNote window to open them in new tabs instantly.

Powerful Customization

• ⌨️ Fully Configurable Global Hotkeys: Take full control of your workflow by customizing the keyboard shortcuts for creating a new note, closing a tab, and showing/hiding the application window.
• ⚙️ Workflow Preferences: Streamline your process by setting a default save path for new notes and choosing a default file format (.txt, .md, etc.), minimizing repetitive actions.
• 🌐 Multi-Language Interface: Switch between English and Traditional Chinese on-the-fly. The entire UI, from settings to status bar, will update instantly.

Advanced Workflow & Productivity

• 💾 Smart Save System: QuickNote is smart about saving. It uses Save for existing files and automatically prompts Save As... for new, untitled notes, ensuring you never accidentally overwrite the wrong file.
• 🛡️ Unsaved Changes Protection: Never lose your work again. QuickNote will warn you and ask for confirmation before closing a tab with unsaved changes.
• 📦 Intelligent System Tray Menu: Access core functions without even opening the window. The tray icon provides quick actions for "New Note", "Save", and more, plus a dynamic list of Recently Closed Files for one-click reopening.
• 📚 Batch File Opening: Select and open multiple files at once from the file dialog. QuickNote will neatly open each file in its own new tab, ready for you to work on.

🛠️ Tech Stack

Area	Technology
Core
Frontend
State
Build

📦 Download & Install

🚀 For Users

⬇️ Download for macOS (.dmg)

Or visit the Releases page for all versions

🌐 Web Version

Visit our web version to try QuickNote in your browser!

Note: The web version is a demonstration of the interface. For the full desktop experience with all features, please download the macOS app.

Option 1: One-Command Installation (Recommended)

curl -L -o QuickNote.dmg "https://github.com/kaigiii/QuickNote-for-macOS/releases/latest/download/QuickNote_0.1.0_aarch64.dmg" && sudo xattr -rd com.apple.quarantine QuickNote.dmg && open QuickNote.dmg

Option 2: Manual Download & Install

1. Download QuickNote_0.1.0_aarch64.dmg from the link above
2. Open Terminal and run:

   sudo xattr -rd com.apple.quarantine /path/to/QuickNote_0.1.0_aarch64.dmg

3. Open the DMG file and drag QuickNote.app to Applications folder

If you see "QuickNote is damaged and can't be opened":

• Go to System Preferences → Security & Privacy → General
• Click "Open Anyway" next to QuickNote
• Or right-click the app and select "Open"

---

🛠️ For Developers

📦 Getting Started

Prerequisites

• Node.js
• Rust and Cargo
• Follow the Tauri prerequisites guide for your specific OS.

Installation & Running

1. Clone the repository:

   git clone https://github.com/kaigiii/QuickNote-for-macOS.git
   cd QuickNote-for-macOS

2. Install frontend dependencies:

   npm install

3. Run in development mode:

   npm run tauri dev

4. Build the application:

   npm run tauri build

📜 License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).

This means:

• You are free to share and adapt the material for non-commercial purposes.
• You must give appropriate credit (Attribution).
• You may not use the material for commercial purposes (NonCommercial).
• If you remix, transform, or build upon the material, you must distribute your contributions under the same license (ShareAlike).

For the full license text, see LICENSE or visit the Creative Commons website.

❤️ Contributing

Contributions are welcome! Whether it's reporting a bug, suggesting a feature, or submitting a pull request, your help is appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request