Skip to content

mnzsss/mrunner

Repository files navigation

MRunner banner

MRunner

A fast, keyboard-first application runner for Linux

MRunner is a fast, keyboard-driven application runner designed for Linux users who prefer speed, simplicity, and minimalism.

Launch applications, open folders, manage bookmarks, and execute common actions — all without leaving the keyboard.


Key Features

  • ⚡ Instant application launching
  • ⭐ Bookmark support for quick access to websites and paths
  • 📂 Open folders and project directories
  • ⌨️ Keyboard-first workflow
  • 🧠 Simple commands for common actions
  • 🪶 Lightweight and fast

Bookmarks

MRunner includes built-in bookmark support to speed up your daily workflow.

Create and access bookmarks directly from the runner to open:

  • Frequently used websites
  • Local directories
  • Common resources

Everything is accessible in seconds — no browser hunting or menu digging.


Philosophy

MRunner is built with a clear goal: stay simple.

It focuses on the most common tasks performed every day and avoids unnecessary features, heavy customization layers, or complex configuration files.

If you live on the keyboard, MRunner is designed for you.


Installation

Arch Linux (AUR)

Install using an AUR helper:

yay -S mrunner

Or use your preferred AUR helper.


Usage

Open MRunner using your configured shortcut and start typing:

  • Application names
  • Folder paths
  • Bookmark names
  • Common commands

Results appear instantly as you type.


Roadmap

Planned improvements include:

  • Extended bookmark management
  • Custom command actions
  • Plugin or extension support
  • Configuration improvements

The project aims to grow without losing its simplicity.


Contributing

Contributions are welcome.

If you have ideas, bug reports, or improvements, open an issue or submit a pull request.


License

MIT License