Ⅰ. 插件描述
a heavy-metal music player for vim – :guitar: :metal: :zap:Ⅱ. 基本信息
|
Ⅲ. 安装方法
使用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,
..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
git clone https://github.com/pmeinhardt/thrasher.git ~/.vim/bundle
Remember to run :helptags to generate the help tags.
Plugin 'pmeinhardt/thrasher'
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.