https://github.com/balsoft/lambda-launcher

Application launcher in haskell. Mostly Just For Fun.
https://github.com/balsoft/lambda-launcher

haskell haskell-application lambda launcher

Last synced: 2 months ago
JSON representation

Application launcher in haskell. Mostly Just For Fun.

• Host: GitHub
• URL: https://github.com/balsoft/lambda-launcher
• Owner: balsoft
• License: unlicense
• Created: 2019-03-23T15:45:16.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-06-11T21:47:03.000Z (over 2 years ago)
• Last Synced: 2024-06-19T23:58:28.196Z (4 months ago)
• Topics: haskell, haskell-application, lambda, launcher
• Language: Haskell
• Size: 172 KB
• Stars: 72
• Watchers: 6
• Forks: 6
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# λauncher [![Build Status](https://travis-ci.com/balsoft/lambda-launcher.svg?branch=master)](https://travis-ci.com/balsoft/lambda-launcher)

λauncher is a GTK launcher application built with Haskell and 

gtk-gi-declarative.

## Screenshots

![Search for "hello world" on duckduckgo](./screenshots/adwaita_hello_world.png)

![All results for "firefox" (command launcher, calculator, window switcher)](./screenshots/black_high_contrast_firefox.png)

## Features

 -  Asynchronous plugin result loading

 -  No runtime settings (not a bug, but a feature)

 -  5M memory on coldstart, 20M memory when all plugins are loaded

 -  Very quick startup (compared to some other graphical launchers

## Configuration

All configuration at this moment is done by editing source files. This will be changed in the future to XMonad-style configuration.

### Plugins

To configure the plugins, edit `plugins :: [Plugin]` in `src/Main.hs`. You should be able to just edit the list of plugins to disable the unneeded ones. All of plugins are enabled by default.

#### Triggers

Apply `trigger` to a plugin to make it the only plugin shown when query starts with a trigger, and apply `triggerStrict` to show a plugin only when it's triggered.

### Window

Edit `configuration` top-level binding in `src/Main.hs`. The `Configuration` type constructor's field names should be self-explanatory.

## Building

### Nix

`nix build` should do everything for you.

### Cabal

`cabal new-run` works for me. If it doesn't, add an issue!

## Current list of plugins 

| Name            | Trigger | Description                                         | Required dependencies | Optional dependencies |

|-----------------|---------|-----------------------------------------------------|-----------------------|-----------------------|

| Clipman         | cp      | get entries from clipman clipboard manager          | clipman               |                       |

| Command         | $       | run shell commands, with suggestions                |                       |                       |

| Duckduckgo      | ddg     | search the web with DDG instant answers             |                       |                       |

| Emacs           | em      | open emacs in a directory from ~/projects           | emacs                 | nix-shell             |

| Files           | file    | list and open files                                 |                       |                       |

| Google          | g       | search some text through google's web interface     |                       |                       |

| GoogleTranslate | tr      | translate words and phrases with Google's api       |                       |                       |

| Kill            | kill    | kill other processes                                | pkill, ps             |                       |

| Pass            | pass    | copy passwords from password store to the clipboard | pass                  |                       |

| Qalc            | q       | use libqalculate to evaluate expressions            | qalc                  |                       |

| Stackoverflow   | so      | search for questions with similar titles            |                       |                       |

| Sway            | sw      | list and focus windows on sway                      | swaymsg               |                       |

| Wiki            | wiki    | search english wikipedia                            |                       |                       |

| Wmctrl          | win     | list and focus windows on X11                       | wmctrl                |                       |

If a plugin doesn't work, make sure you've installed the corresponding dependencies!

## Extending

 -  Create `src/Plugins/YourPlugin.hs` that exports 

    `yourPlugin :: String -> IO [Types.Result]`

 -  Add the corresponding import to `src/Plugins/Main.hs`

 -  Don't forget to add `yourPlugin` to `plugins` list

 -  Send a PR!

## Code of conduct

All contributions are welcome! There are no restrictions.

## License

This work is in public domain. By sending Pull Requests you agree that

all of your work assosiated with this software is in public domain as

well.

This only applies to the code contained in this repository, to see

licenses of it's dependencies visit their respective pages.

## WARRANTY

THIS SOFTWARE COMES "AS IS", WITHOUT ANY WARRANTY (IMPLIED OR

OTHERWISE) TO THE EXTENT PERMITTED BY THE APPLICABLE LAWS. IT MAY

CAUSE DATA CORRUPTION OR LOSS. BY RUNNING THIS SOFTWARE YOU AGREE 

THAT IT'S AUTHOR(S) ARE NOT RESPONSIBLE FOR ANY DAMAGE CAUSED BY 

THIS SOFTWARE.