Skip to content

GabbyRichards/albert

 
 

Repository files navigation

Albert launcher

GitHub tag (latest by date) Docker CI Status OBS status Telegram community chat Discord IRC IRC Web Client

Albert is a plugin based, desktop agnostic C++/Qt keyboard launcher that helps you to accomplish your workflows in a breeze.

Contents

Features

  • Usability: Albert is your shortcut to a more efficient workflow. Launch applications, search the web, or execute custom commands with ease.
  • Performance: Lightning-fast responsiveness ensures you stay productive without delay.
  • Extensibility: Customize and extend Albert's functionality through a wide range of plugins.
  • Beauty: An elegant and intuitive design that enhances your desktop experience.

Getting Started

Installation

Unofficial packages and repository sources may contain malicious code! Please make sure to use the sources mentioned here to install albert.

Using official Albert repositories

  1. Visit OBS Software Repo.
  2. Choose your Linux distribution from the available options: Arch, Debian, Fedora, openSUSE, Raspbian, Ubuntu.
  3. Add repository and install manually using provided instructions.

If the list is lacking one of the latest distributions join the chats and let us know. There is a also bleeding edge master branch package available.

Building from source

Building from sources is the least convenient, but most flexible way. This way is usually for developers only. The build process is trivial, but you have to manage the dependencies on your own. See the OBS package specs for up to date build and runtime dependencies.

  1. Install CMake.
  2. Clone, build, and install Albert.
git clone --recursive https://github.com/albertlauncher/albert.git
cmake -B build -S albert -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
cmake --build build
cmake --install build

Usage

As you would expect from a launcher, the main use case is to type a query into an input box and finally to interact with some sort of results. Actually there is not much more Albert allows you to do - triggering things. No more, no less.

For reference, visit the website to see all keys you can use to control Albert (v0.18).

Extension

Albert has a flexible, nested plugin system, which gives users and developers the ability to extend its functionality.

Native plugins

The native way is to use C++/Qt to write a QPlugin. This gives you the performance of C++ and a host of other advantages. See the docs on native plugins especially the albert namespace. Also check the plugins repo for an up to date list of plugins.

Python plugins

The Python plugin adds plugins via Python modules. Check the docs of the Python plugin and the python repo for an up to date list of plugins.

Contributions

We welcome contributions from the community! If you would like to get involved, feel free to:

  • Spread the word and leave a star.
  • Join the community and help other users.
  • Create and/or maintain official plugins.
  • Use the application and report issues.
  • Check the issues and try to help debugging.
  • Improve the documentation.
  • Support me as a creator by becoming a sponsor or donating some bucks.

License

Distributed under the Manuel Schneider Albert license v1.0. See LICENSE.md for more information.

Support and Feedback

Your feedback is essential in making Albert better. If you encounter any issues or have suggestions for improvements, please let us know through our community channels:

You can also Visit the website for more documentation on installing, using, extending or troubleshooting Albert.

Have fun with Albert!!! If you do not, tell me why. If you like it, feel free to tip me.

About

A fast and flexible keyboard launcher

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 83.3%
  • CMake 7.2%
  • Objective-C++ 5.2%
  • Python 2.8%
  • Other 1.5%