thrasher


Ⅰ. 插件描述

a heavy-metal music player for vim – :guitar: :metal: :zap:

Ⅱ. 基本信息

创建日期:  2016-04-13
使用用户:  1
Github星:  3
插件作者:  Paul Meinhardt

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:
Plugin 'pmeinhardt/thrasher'
… 然后在Vim中运行以下命令:
:source %
:PluginInstall

对于Vundle版本 < 0.10.2,请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:
NeoBundle 'pmeinhardt/thrasher'
… 然后在Vim中运行以下命令:
:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:
Plug 'pmeinhardt/thrasher'
… 然后在Vim中运行以下命令:
:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:
cd ~/.vim/bundle
git clone https://github.com/pmeinhardt/thrasher

Ⅳ. 文档说明

THRASHER - A HEAVY-METAL MUSIC PLAYER FOR VIM

                                                                ,'
                                                             .c0:
                                                           .dNX'
                                            ..           ,kMM0.
                                           'KX'       .cKMMMd.
                                          :WMMWl.   .oNMMMWc
                                        .xMMMMMM0.,kWMMMMN,
                                       .KMMMMMMMMMMMMMMM0.
                                      ;NMMMMMMMMMMMMMMMx.
                                    .oMMMMMMXMMMMMMMMWl
                                   .0MMMMWk' cWMMMMMN,
                                  ,NMMMXl.    ,NMMMK.
                                 oMMMO;.       .0Mk.
                               .OMWd.           .;
                              'XKc.
                             ck,
                            ..

U+1F5F2

What the heck?

Currently this project is in an experimental state,
but it is beginning to be actually usable (for me at least).
At the moment, Thrasher only works with iTunes on Mac OS X.
The idea is, of course, to support controlling other players as well.

If you're brave (curious) enough to give this project a try,
I'd love to hear back from you. Let me know what you think.

Thanks. You rock!

Using

Basic usage

To bring up Thrasher's interface, type <leader>m.

Personally, I have mapped <leader> to ,, which makes this key combination
very easy to type (on an English keyboard). You can easily
change the default though.

The interface may take a moment to appear for the first time,
because it is caching track information in the background.
Following invocations should then be instantaneous.

You can then start typing to search for tracks matching your input.

Thrasher allows searching by artist, album or track name, and also
lets you look for tracks with any of these properties matching your query.
To switch between search modes, press ctrl-v (<c-v>).

You can scroll through the list of found tracks, using <c-j> to go down and
<c-k> to move up.

Hit <enter> to play the selected song!

To close, hit <esc> or <c-c>.

Advanced

Inputting (prompt focus)

  • type to search (letters, numbers, spaces…)
  • <c-h> moves the cursor left
  • <c-l> moves the cursor right
  • <c-e> jumps to the very end of your input
  • <c-a> places the prompt cursor at the start
  • <bs> deletes the preceding character
  • <del> deletes the current character
  • <c-w> deletes the word in front of the cursor
  • <c-u> deletes your entire search input

Navigation

  • <c-j> moves the track selection down
  • <c-k> moves the track selection up

Search modes

  • <c-v> switch between search modes (any/artist/album/track)

Player control

  • <c-g> toggles between play and pause
  • <c-f> skips forward to the next track
  • <c-b> lets you return to the previous track

Focus

  • <s-tab> switches between prompt and window focus

The prompt controls for entering queries are explained above.
Thrasher will launch with prompt focus by default.

With window focus you can navigate the result list more easily,
using standard vim navigation mappings. Hit <cr> to play the selection,
<esc> to close or <s-tab> to switch back to prompt focus.

The player controls and search mode mappings are available both with
prompt and window focus.

Further documentation

To open the vim documentation, run :help thrasher.

Installing

Pathogen

git clone https://github.com/pmeinhardt/thrasher.git ~/.vim/bundle

Remember to run :helptags to generate the help tags.

Vundle

Plugin 'pmeinhardt/thrasher'

Plug

Plug 'pmeinhardt/thrasher'

Configuration

You can change the default key mapping for invoking Thrasher,
simply by adding let g:thrashermap = "…" to your .vimrc file.

Make sure to add these options before executing pathogen#infect(),
calling vundle#end() or plug#end() – i.e. before loading the plugin.

Contributing

There are many ways in which you could contribute: Through code, by creating
pull-requests, but mainly by just providing me with feedback and
your thoughts on what to improve.

Thanks

This project boldly steals some user interface ideas from the very useful
ctrlp,
a vim plugin which has been making my vim a lot more fun.

添加新评论