Skip to content

Latest commit

 

History

History
101 lines (72 loc) · 7.09 KB

README.md

File metadata and controls

101 lines (72 loc) · 7.09 KB

checks codeql reuse downloads sponsors Discord docs

What is Kando?

Kando is a cross-platform pie menu for your desktop. It offers an unconventional, fast, highly efficient, and fun way of interacting with your computer! You can use Kando to launch applications, simulate keyboard shortcuts, open files, and much more.

Kando is designed to be used with 🖱️ mouse, 🖊️ stylus, or 👆 touch input. If you have both hands at your keyboard most of the time, Kando is maybe not the right tool for you.

You are welcome to join the 💬 Discord server to discuss the project, ask questions, or just to hang out with other Kando enthusiasts!

Platform Support

Implementing a menu like Kando in a cross-platform manner is not exactly easy. Things like getting the mouse position before opening a window, simulating key presses, or getting the name of the currently focused application window has to be implemented differently on each platform.

For now, Kando has been tested on the following platforms:

Tested Environment Status Notes
 Windows ✔️
 macOS ✔️
 GNOME / X11 ✔️
 GNOME / Wayland ✔️ Requires adapter GNOME Shell extension which provides a DBus interface for Kando to communicate with.
 KDE / X11 ✔️
 KDE / Wayland ✔️ Works both on Plasma 5 and Plasma 6. See platform-specific notes for some details.
Hyprland ✔️ See platform-specific notes for some details.
 XFCE ✔️
 MATE ✔️
 Budgie ✔️
 Cinnamon ✔️
 LXQt ✔️
 LXDE ✔️ Requires a compositor for the transparency to work.
 Openbox ✔️ Requires a compositor for the transparency to work.
 i3 ✔️ Requires a compositor for the transparency to work.
 dusk ✔️ Requires a compositor for the transparency to work. See platform-specific notes for some details.

📦 Installation

You can either download a prebuilt binary or compile Kando yourself. For both approaches there are instructions available in the 📝 Installation Guide.

🚀 Getting Started

Kando comes with an example menu which you can open by pressing Ctrl+Space on most platforms. This is great to get a first impression! To learn some basics about the interaction with Kando, you can have a look at the 📝 Usage Guide.

Once you are familiar with the basics, you can start creating your own menus. Learn how to create your own menus in the 📝 Configuration Guide!

💞 I want to contribute!

I am creating Kando out of sheer passion. It is completely free, and I am not planning to monetize it in any way. But I would be very happy if you could support the project with creative ideas, code contributions, or by sharing it with your friends and followers! 💖

There are always some open issues labeled as good first issue which are a great starting point for new contributors. Just drop a comment if you want to work on one of these issues, and we can discuss the details!

While direct contributions are the most awesome way to support the development, donations will encourage me to invest my spare time for developing free and open-source software.

kofi github paypal crypto

These awesome people have already donated to the development of my open-source projects:

Sponsors List

Credits

This README uses icons from Simple Icons.