Skip to content

QuickNotes is a plugin for [Microsoft PowerToys Run](https://github.com/microsoft/PowerToys) that allows you to quickly create, manage, and search notes directly from your PowerToys Run interface. Simply type `qq` followed by your note text to save it,

License

Notifications You must be signed in to change notification settings

ruslanlap/CommunityPowerToysRunPlugin-QuickNotes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“ PowerToys Run: QuickNotes Plugin

QuickNotes Demo QuickNotes Icon

Create, manage, and search notes directly from PowerToys Run

SHA256 Checksums
# Checksums will be updated after v1.0.9 release
# QuickNotes-1.0.9-x64.zip
# QuickNotes-1.0.9-arm64.zip

πŸš€ v1.0.9: Improved multi-line notes with better code snippet support. Full changelog

πŸ”„ v1.0.8: PowerToys Run plugin validation compliance, optimized dependencies

πŸ”„ v1.0.7: Enhanced note deletion with better confirmation dialogs and ID-based identification

πŸ“ v1.0.6: Reworked note management system fixing critical bugs with deletion and editing

πŸ“‹ Overview

QuickNotes is a plugin for Microsoft PowerToys Run that allows you to quickly create, manage, and search notes directly from your PowerToys Run interface. Simply type qq followed by your note text to save it, or use various commands to manage your notes collection.

πŸ“š Documentation

For detailed documentation, visit the QuickNotes Wiki.

⚑ Installation

Quick Install

  1. Download the x64 or ARM64 version
  2. Extract to %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins\
  3. Restart PowerToys
  4. Start using with Alt+Space then type qq

PowerShell Installation

# Download and install the latest version (x64)
$url = "https://github.com/ruslanlap/CommunityPowerToysRunPlugin-QuickNotes/releases/download/v1.0.9/QuickNotes-1.0.9-x64.zip"
$pluginPath = "$env:LOCALAPPDATA\Microsoft\PowerToys\PowerToys Run\Plugins\QuickNotes"
New-Item -ItemType Directory -Force -Path $pluginPath | Out-Null
Invoke-WebRequest -Uri $url -OutFile "$env:TEMP\QuickNotes.zip"
Expand-Archive -Path "$env:TEMP\QuickNotes.zip" -DestinationPath $pluginPath -Force
Remove-Item "$env:TEMP\QuickNotes.zip"
Write-Host "QuickNotes plugin has been installed. Please restart PowerToys." -ForegroundColor Green

✨ Features

  • πŸ“ Quick Note Creation - Instantly save notes with a simple command
  • πŸ” Powerful Search - Find notes with highlighted search terms
  • 🏷️ Tag Support - Add #tags to notes and search by tag
  • πŸ“Œ Pin Important Notes - Pin critical notes to keep them at the top
  • ✨ Full Markdown Support - Format with headers, code blocks, lists, and more
  • πŸ“ Multi-Line Notes - Rich editor with live preview for longer notes
  • πŸ“‹ Clipboard Integration - Copy notes with a single click
  • πŸ”„ Undo Delete - Restore recently deleted notes
  • πŸ’Ύ Simple Backup - Create backups of your notes collection

πŸ”§ Usage

Open PowerToys Run (default: Alt + Space) and use these commands:

Command Description
qq <text> Create a new note
qq help Show help information
qq search <term> Search notes with highlighted matches
qq searchtag <tag> Search notes by tag
qq view <number> View note details
qq edit <number> Edit a specific note
qq del <number> Delete a specific note
qq delall Delete all notes
qq undo Restore last deleted note
qq pin <number> Pin a note to the top
qq unpin <number> Unpin a note
qq sort date Sort notes by date
qq sort alpha Sort notes alphabetically
qq backup Backup notes
qq markdown Create multi-line markdown note

πŸ‘‰ Quick Tips

  • Press Enter on a note to copy it to clipboard
  • Right-click for more options (copy, edit, delete, pin/unpin)
  • Add #tags to notes: qq Meeting with John #work #important
  • Format with Markdown:
    • Bold: **text** or __text__
    • Italic: *text* or _text_
    • Code: `code`
    • Headers: # Heading
    • Lists: - item or 1. item
  • Use Ctrl+C to copy with timestamp
  • Type qq then press Tab for command suggestions
  • URLs in notes are automatically detected and clickable

🎬 Demo

QuickNotes Demo

QuickNotes in action

More Demos

πŸ“ Data Storage

QuickNotes stores all your notes in a simple text file at:

%LOCALAPPDATA%\Microsoft\PowerToys\QuickNotes\notes.txt

πŸ› οΈ Building from Source

Prerequisites

Build Steps

  1. Clone the repository
  2. Open the solution in Visual Studio
  3. Build the solution: dotnet build -c Release

🀝 Contributing

Contributions are welcome! Please check the Contributing Guidelines for more information.

❓ FAQ

How do I update the plugin?

Download the latest release and replace the files in your PowerToys Plugins directory. Restart PowerToys afterward.

Can I sync my notes across devices?

The plugin doesn't have built-in sync, but you can place the notes.txt file in a cloud-synced folder and create a symbolic link to it.

What if I accidentally delete all my notes?

If you've created backups using the qq backup command, you can restore from those. Otherwise, you might be able to recover from Windows File History if enabled.

Can I change the storage location?

Currently, the storage location is fixed. A future update may add customizable storage locations.

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgements

  • Microsoft PowerToys team for creating the extensible PowerToys Run platform
  • All contributors who have helped improve this plugin
  • Icons and visual elements from various open-source projects

πŸ“₯ Download Latest Version

Download x64 Download ARM64 View All Releases

Made with ❀️ by ruslanlap

Back to top ⬆️

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgements

  • Microsoft PowerToys team for creating the extensible PowerToys Run platform
  • All contributors who have helped improve this plugin
  • Icons and visual elements from various open-source projects

🧩 Notable Features

  • Timestamp Management: Automatically adds timestamps to notes and provides options to display or hide them
  • Tag Detection: Identifies and formats #tags with customizable styling (bold or italic)
  • URL Detection: Uses regex to find and make URLs clickable in notes
  • Undo Functionality: Tracks deleted notes to enable undo operations
  • Sort Capabilities: Implements flexible sorting by date or alphabetically
  • Autocomplete: Provides intelligent command suggestions as you type

The implementation prioritizes user experience with features like:

  • Clean content copying (stripping timestamps and tags)
  • Intelligent display of pinned vs. regular notes
  • Comprehensive error handling
  • Helpful tooltips and notifications
  • Flexible search capabilities

This robust architecture makes QuickNotes not just a simple note-taking plugin, but a powerful productivity tool that seamlessly integrates with PowerToys Run.

For more detailed implementation information, see the IMPLEMENTATION_SUMMARY.md file.

About

QuickNotes is a plugin for [Microsoft PowerToys Run](https://github.com/microsoft/PowerToys) that allows you to quickly create, manage, and search notes directly from your PowerToys Run interface. Simply type `qq` followed by your note text to save it,

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published