Giter Club home page Giter Club logo

ulauncher's Introduction

Master: Build Status Dev: Build Status

Ulauncher is a fast application launcher for Linux. It's is written in Python, using GTK+.

App Search File Browser Custom Themes
screenshot screenshot screenshot

Download it at ulauncher.io

As of Ulauncher v3, you can create your own Ulauncher extensions Check out docs.ulauncher.io to find out how.

As of Ulauncher v4, you can create your own color themes Check out docs.ulauncher.io to find out how.

Known Issues

Code Contribution

Project Contributor-friendly Issues
Ulauncher App GitHub issues by-label
GitHub issues by-label
GitHub issues by-label
GitHub issues by-label
Frontend for extensions website
Uses ReactJS
GitHub issues by-label
API for extensions website
Uses Python and bottle library
GitHub issues by-label

Any code contributions are welcomed as long as they are discussed in Github Issues with maintainers. Be aware that if you decide to change something and submit a PR on your own, it may not be accepted.

Checkout Code Contribution Guidelines for more info.

Setup Development Environment

You must have the following things installed:

  • Docker

  • python3-distutils-extra

  • Application runtime dependencies. (You don't have to manually install these if you have already installed Ulauncher)

    sudo apt-get install \
      libkeybinder-3.0-0 \
      libgtk-3-0 \
      gir1.2-gtk-3.0 \
      gir1.2-keybinder-3.0 \
      gir1.2-webkit2-4.0 \
      gir1.2-glib-2.0 \
      gir1.2-notify-0.7 \
      gir1.2-gdkpixbuf-2.0 \
      gir1.2-appindicator3-0.1 \
      python3-dbus \
      python3-levenshtein \
      python3-pyinotify \
      python3-websocket \
      python3-xdg
    

Build and Run

  1. $ ./ul init-dev-env installs Ulauncher data to ~/.local/share/ulauncher/
  2. $ ./ul dev-container will take you into a Docker container from which you can run build and test scripts. Use sudo -E ./ul dev-container if your user is not in the docker group.
  3. root@container: # ./ul build-preferences build preferences UI in JS/HTML
  4. root@container: # ./ul test runs linter, type checker, and unit tests
  5. $ ./ul run runs the app

Check out output of ./ul to find more useful commands.

License

See the LICENSE file for license rights and limitations (GNU GPL v3.0).

ulauncher's People

Contributors

gornostal avatar cjbassi avatar yatsenko avatar goodwillcoding avatar friday avatar dev99problems avatar dalanicolai avatar subdavis avatar branb avatar igormael avatar jetbug123 avatar khrlimam avatar kisaragi-hiu avatar hickscorp avatar nikazooz avatar fuhrmann avatar sgreene570 avatar thanhvg avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.