Credits

Inspired by Bookmark by @M00t3.

---

QuickSearchMac

A powerful, minimal bookmark launcher and search shortcut tool for macOS

Launch websites via abbreviations or search within predefined sources through Raycast. QuickSearch lets you access your favorite sites and search engines with just a few keystrokes.

Requirements

• macOS
• Raycast
• Python 3.x

Installation

1. Clone the Repository

   git clone https://github.com/YOUR_USERNAME/QuickSearchMac.git ~/QuickSearchMac

2. Verify Python Installation

   python3 --version

   No additional Python packages are required.

3. Configuration Files

   All necessary configuration files are included in the repository:

   • config.ini: Contains browser and environment settings
   • .sites.txt: Default bookmarked URLs
   • .quick_search.txt: Default abbreviation mappings

   These files will be automatically set up during installation. You can modify them later according to your preferences.

Raycast Integration

1. **Create Script **

   In Raycast: creat script command

##Save them in a dir(folder) that you want.

2. Update Script Files

   qs.sh - Quick Search

   #!/bin/bash
   
   # Required parameters:
   # @raycast.schemaVersion 1
   # @raycast.title qs
   # @raycast.mode compact
   # @raycast.argument1 { "type": "text", "placeholder": "Abbreviation" }
   # @raycast.argument2 { "type": "text", "placeholder": "Search term", "optional": true }
   
   # Optional parameters:
   # @raycast.icon 🔍
   
   python3 ~/QuickSearchMac/bookmark.py --quick-search "$1" "$2"

   aqs.sh - Add Quick Site

   #!/bin/bash
   
   # Required parameters:
   # @raycast.schemaVersion 1
   # @raycast.title aqs
   # @raycast.mode compact
   # @raycast.argument1 { "type": "text", "placeholder": "Abbreviation" }
   # @raycast.argument2 { "type": "text", "placeholder": "Full URL" }
   
   # Optional parameters:
   # @raycast.icon ➕
   
   python3 ~/QuickSearchMac/add_site.py "$1" "$2"

3. Make Scripts Executable

   chmod +x ~/YOURPATH/qs.sh ~/YOURPATH/aqs.sh

Usage Examples (Icons are changed)

Usage Examples without Raycast

Quick Search (qs)

Search YouTube for "linux tips":

qs yt linux tips

↳ Opens: https://www.youtube.com/results?search_query=linux tips

Open GitHub (if abbreviation exists):

qs gh

↳ Opens: https://github.com

Add Quick Site (aqs)

Add GitHub abbreviation:

aqs gh https://github.com

↳ Adds entry to configuration files

Project Structure

QuickSearchMac/
│
├── bookmark.py             # Main script handling searches
├── add_site.py             # Script to add site abbreviations
├── quick_search_config.py  # Abbreviation dictionary
├── config.ini              # Configuration file
├── .sites.txt              # List of bookmarked URLs
├── .quick_search.txt       # Abbreviation to URL mappings

Features

• Lightning-fast searches - Launch websites with just a few keystrokes
• Customizable abbreviations - Create your own shortcuts for any website
• Seamless integration with Raycast
• Minimal dependencies - Just Python and Raycast required
• Cross-browser support - Configure your preferred browser

Contributing

Contributions are welcome!

Please open an issue or submit a pull request.

License

This project is open source and available under the MIT License.