Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bayleeadamoss/zazu

:rocket: A fully extensible and open source launcher for hackers, creators and dabblers.
https://github.com/bayleeadamoss/zazu

alfred core extensible hackers launcher platform spotlight zazu

Last synced: about 1 month ago
JSON representation

:rocket: A fully extensible and open source launcher for hackers, creators and dabblers.

Awesome Lists containing this project

README

        

## Zazu

[![Join the chat at https://gitter.im/tinytacoteam/zazu](https://badges.gitter.im/tinytacoteam/zazu.svg)](https://gitter.im/tinytacoteam/zazu?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Travis Build Status](https://travis-ci.org/tinytacoteam/zazu.svg?branch=master)](https://travis-ci.org/tinytacoteam/zazu)
[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/mhfi0vyyo7dygqiu/branch/master?svg=true)](https://ci.appveyor.com/project/blainesch/zazu)

Zazu, is a cross platform and fully extensible and open source launcher for
hackers, creators and dabblers. Download it from the [releases
page](http://zazuapp.org/download).

Zazu was created to be a fully open source alternative to Alfred, but also be
completely plugin based. You can remove any functionality you don't like, so if
you hate the built in calculator, just get a new one!

We also have all of your configuration in a dotfile in `~/.zazurc.json` so it can
be backed up and synced!

Be sure to check out our amazing [Documentation](http://zazuapp.org).

## Action Shot

### Introduction Video

[![Zazu App - Introduction](docs/images/action-shots/video.png)](https://vimeo.com/206729309)

### Package Manager

Manage your plugins from within Zazu.

![Zazu App - Package Manager Plugin](docs/images/action-shots/package-manager.png)

### Calculator

Accepts some common equations for you to copy to your clipboard.

![Zazu App - Calculator Plugin](docs/images/action-shots/calculator.png)

### Clipboard History

Remembers things so you don't have to! Fuzzy search and browser all the things
you've copied.

![Zazu App - Clipboard History](docs/images/action-shots/clipboard.png)

### File Finder

Find Applications or files deep in your file system.

![Zazu App - File Finder](docs/images/action-shots/file-finder.png)

### System Commands

Switch on your screen saver, lock your computer, and more!

![Zazu App - System](docs/images/action-shots/system.png)

### Build your own!

Zazu is completely open, so build your plugins. You can [get started building
your plugin](http://zazuapp.org//documentation/plugins/) then head over and
submit it to the [plugins](http://zazuapp.org/plugins/) gallery!

## Development

As you might expect:

~~~
npm install
npm start
~~~

If you enable debug mode it will make it so Zazu won't hide and the dev tools
will open by default. You can enable debug mode by adding a `debug` flag to
`true` inside of your `~/.zazurc.json`

If `blur` flag is `false`, then Zazu won't hide when it lost focus.

~~~ javascript
{
"debug": true,
"blur": false,
"hotkey": "cmd+space",
"theme": "tinytacoteam/zazu-playful-theme",
"plugins": []
}
~~~

## Deployment

To deploy simple update the version in both `package.json` and
`app/package.json` (eg `0.3.2`). After comitting you can tag the release, but
be sure to add the `v` in front (eg `v0.3.2`). Push the commits then the tag.

The CI servers will upload the assets once the tests are done passing, the new
release should be a draft, so once all assets are published you can publish the
release on GitHub.

Lastly, you should re-publish the docs. Zazu uses the doc website to see if a
new release is available so doing a quick release will allow others to download
the newest version. Simply run `npm run docs:publish`.