https://github.com/zgqq/mah

An alternative to alfred written in java
https://github.com/zgqq/mah

alfred java mah productivity

Last synced: 2 months ago
JSON representation

An alternative to alfred written in java

• Host: GitHub
• URL: https://github.com/zgqq/mah
• Owner: zgqq
• License: mit
• Created: 2017-01-19T12:34:39.000Z (about 8 years ago)
• Default Branch: dev
• Last Pushed: 2022-10-15T05:29:43.000Z (over 2 years ago)
• Last Synced: 2024-08-02T01:27:02.486Z (6 months ago)
• Topics: alfred, java, mah, productivity
• Language: Java
• Homepage:
• Size: 18.3 MB
• Stars: 69
• Watchers: 4
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
** No longer maintained(这个项目不再维护了) **

# Mah

Mah is an alternative to alfred,written in java.The project is currently under development.

# Plugins

## Search 

    

            Search

    

    

            

                

            

    

![suggestion](./screenshot/Search.gif "Search")

## Auto suggestion

    

            AutoSuggestion

    

![suggestion](./screenshot/AutoSuggestion.gif "suggestion")

## KeyRecorder plugin

KeyRecorder will record all key strokes with modifier such as Control+c,helping you find out those key strokes pressed most.

    

            KeyRecorder

    

    

        

            

        

    

![github plugin](./screenshot/KeyRecorder.gif "github")

## Translation plugin

First,you need to apply api pair http://fanyi.youdao.com/openapi?path=data-mode

    

            translation

    

    

        

            

            

                {keyfrom}

                {apkey}

            

        

    

![translation plugin](./screenshot/translation.gif "translation")

## Weather plugin

    

            weather

    

    

        

            

            

                beijing

            

        

    

![weather plugin](./screenshot/weather.gif "weather")

## github plugin

First, go to https://github.com/settings/tokens to generate a token

    

            github

    

    

        

            

            

        

        

            

            

                {your github usename}

                

                2

                {your token}

                

            

        

    

![github plugin](./screenshot/github.gif "github")

## More plugins

Java libraries are so powerful that it is easy to develop a plugin.

# Features

## Asynchronous

For example,it will take long time to synchronize github repositories you starred;

you can execute other actions like translation while synchronizing.

## Better keybind

You can bind as many actions as you want.There are many useful actions in Mah.

The mode (input_mode) provides a action named ClearQueryText,which is used to clear

text prior to command.Try to imagine that you have translated a long sentence and want to translate another sentence or word,you need to clear input and input command again.Thanks to this action,you don't need to do so.

## Configurable

Configuration is the one of important features,you can configure keybind,plugin,and so on.To configure keybind,you should know what is Mode.Mode is a collection of keybinds,allowing same keybind to execute different actions.For instance,TranslationCommand will trigger translation_mode,in which CopyWord and CopyExplains actions are defined;then you can press alt+w (i defined,you can configure it freely in conf.xml) to execute CopyWord

 action;as a result,translated word will be copied.

## Plugin support

Mah is totally based on plugin.Thinks to java ecosystem,you can develop a plugin with powerful abilities.

# Getting Started

## Installation

Mah doesn't provide any binary package for user as there are some efforts to do this.So to use

Mah,you must compile it yourself;it is not a big deal,only tough thing is to install jdk8.Once installed,the rest is easy.

    git clone https://github.com/zgqq/mah && cd mah 

    ./install

## Configuration

    Open /{home}/.config/mah/conf.xml with editor,you will see

       

         

          

           

               

           

           

               

           

           

               

               

               

               

           

           

               

               

               

               

               

               

               

               

               

               

               

               

               

               

               

               

               

               

           

           

                   

                   

                   

                   

                   

                   

                   

                   

                   

                   

                   

                   

                   

           

           dark

        

Above is most basic configuration,mah will generate it automatically,you can modify it freely.

Note that you must tell mah if you change key location using tool like xmodmap 

    

        

        

    

## Configuration example 

[conf.xml](https://github.com/zgqq/dotfiles/blob/master/mah/conf.xml)