Skip to content

d41x/launchmat

Repository files navigation

Launchmat 🚀

A powerful Launchpad replacement for macOS built as a Raycast extension. Organize your applications with custom folders and enjoy a beautiful Liquid Glass design, all without affecting your Applications folder.

✨ Features

  • Custom Organization: Create and manage custom folders to organize your apps exactly how you want
  • Launchpad-Style Navigation: Familiar page-based navigation with keyboard shortcuts
  • Liquid Glass Design: Beautiful translucent design that matches macOS Tahoe's aesthetic
  • Non-Intrusive: Organizes apps without modifying your actual Applications folder
  • Smart Categorization: Automatically categorizes new apps into appropriate folders
  • Search & Filter: Quick search across all applications and folders
  • Raycast Integration: Seamlessly integrated with Raycast's theming and UI components

🛠 Installation

From Raycast Store (Coming Soon)

  1. Open Raycast
  2. Search for "Launchmat"
  3. Click Install

Manual Installation (Development)

  1. Clone this repository:

    git clone https://github.com/your-username/launchmat.git
    cd launchmat
  2. Install dependencies:

    npm install
  3. Start development:

    npm run dev

🚀 Usage

Main Commands

  • Launchmat: Main interface to browse and launch applications
  • Launchmat Settings: Configure folders, colors, and organization
  • Quick Add to Folder: Quickly organize applications into folders

Keyboard Shortcuts

  • ←/→ Arrow keys: Navigate between pages
  • ⌘ + N: Create new folder
  • ⌘ + ⌫: Remove app from folder
  • ⌘ + R: Refresh applications
  • ⌘ + ,: Open settings

Gestures & Navigation

  • Page Navigation: Use arrow keys to move between pages of apps
  • Folder Navigation: Click folders to browse their contents
  • Search: Type to search across all apps and folders
  • Back Navigation: Use the back action or ⌘ + ← to return to main view

📁 Folder Management

Default Folders

Launchmat comes with sensible default folders:

  • Productivity: Office apps, note-taking, task management
  • Development: Code editors, terminals, dev tools
  • Graphics & Design: Photo editors, design tools, creative apps
  • Entertainment: Media players, streaming apps
  • Utilities: System utilities, maintenance tools
  • Games: Gaming applications
  • Communication: Email, messaging, video calls
  • Other: Everything else

Custom Folders

  • Create unlimited custom folders
  • Choose from 8 beautiful colors
  • Select appropriate icons for each folder
  • Reorder folders by dragging or using move actions
  • Rename folders anytime

🎨 Design Philosophy

Launchmat embraces the Liquid Glass aesthetic introduced in macOS Tahoe:

  • Translucent Surfaces: Beautiful glass-like interface elements
  • Dynamic Colors: Folders and UI adapt to your Raycast theme
  • Smooth Transitions: Fluid animations and page transitions
  • Modern Typography: Clean, readable text throughout
  • Contextual Actions: Smart action panels based on your current view

🔧 Configuration

Preferences

Access preferences through Raycast settings:

  • Columns: Number of columns in grid view (4-8)
  • Items Per Page: How many items to show per page
  • Auto-organize: Automatically categorize new apps
  • Show App Versions: Display app version numbers
  • Default Folder Color: Color for new folders

Import/Export

  • Export Settings: Backup your folder configuration
  • Import Settings: Restore from backup or share configurations
  • Reset: Clear all data and start fresh

🔒 Privacy & Security

  • Local Storage Only: All data stored locally on your Mac
  • No Network Requests: No data sent to external servers
  • Application Folder Safe: Never modifies your actual Applications folder
  • Raycast Permissions: Uses only necessary Raycast APIs

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature-name
  3. Make your changes and add tests
  4. Run linting: npm run lint
  5. Submit a pull request

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

  • Inspired by the beloved Launchpad feature in macOS
  • Built for the amazing Raycast community
  • Thanks to all beta testers and contributors

📞 Support


Made with ❤️ for the Raycast community

About

For Raycast Extension.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published