scnvim

Note

Please note that this plugin is still in active development. It should be stable enough by now for everyday use. If you encounter any bugs, or have ideas for new features, please report them on the issue tracker, thanks!

Features

Post window is displayed in a regular vim buffer
- Use vim key bindings to navigate/move/copy etc.
- Toggles back if hidden on a SuperCollider error
Interactive argument hints in the command-line area
Status line widgets
- Display SuperCollider server status in vim status line.
Snippet generator
- Generates snippets for all creation methods in SCClassLibrary.
Can be used with Neovim GUI frontends
Supports lazy loading
Context aware evaluation (like Cmd-Enter in scIDE)
Flashy eval flash (configurable)

Showcase

Post window displayed in a regular vim buffer

Toggle the post window buffer by pressing <Enter> in normal mode or <M-Enter> in insert mode.

Interactive argument hints in the command-line area

Arguments are automatically displayed after typing the opening brace.

Status line widgets

Displays server status in the status line

Snippet generator

The snippet engine used here is UltiSnips together with deoplete for auto completion.

Installation

Requirements

Neovim (tested with >= 0.3.1)
SuperCollider
pynvim (optional)

Installation

Here is an example using vim-plug

Add this line to your init.vim

Plug 'davidgranstrom/scnvim', { 'do': ':UpdateRemotePlugins' }

:PlugInstall
Exit nvim
Install the SCNvim SuperCollider classes

The SuperCollider classes are located in the sc/ directory of this repo.

This directory needs to be linked to your SuperCollider Extensions directory (run Platform.userExtensionDir in SuperCollider to see where it is located on your platform).

Create a symlink (symbolic link) like in the example below. It is important that the link is named scide_scvim (note the omitted 'n') to avoid conflicts with ScIDE.

Example:

ln -s <PATH_TO_SCNVIM_PLUGIN>/sc ~/Library/Application\ Support/SuperCollider/Extensions/scide_scvim

Open a new file in nvim with a .scd or .sc extension and type :SCNvimStart to start SuperCollider.

Remote plugin

Some features of scnvim are implemented as a remote plugin which can communicate to SuperCollider via UDP. If you want to use the echo args or statusline update features you will need to install the python3 client pynvim.

pip3 install pynvim --user

Please visit the pynvim repo to read the official installation instructions and how to upgrade to newer versions.

Syntax highlighting

Run :SCNvimTags after starting SuperCollider to generate a file used for syntax highlighting.

The command will also generate a file with snippet definitions for all object creation methods and also a tags file which can be used to navigate to references using the built-in vim command C-] (jump to definition).

If you write or install new classes you will need to run this command again to update the syntax/tags/snippets files.

Snippets

Run :SCNvimTags to generate the snippet definitions.

You will also need a snippet engine like UltiSnips in order to use the snippets. To let UltiSnips know about the snippets put the following line in your init.vim:

let g:UltiSnipsSnippetDirectories = ['UltiSnips', 'scnvim-data']

Status line widgets

scnvim provides some functions suitable to use in your vim statusline.

scnvim#statusline#server_status

Run :SCNvimStatusLine to get feedback in the status line.

See the example configuration on how they can be used.

This command calls SCNvim.statusLineUpdate(<interval>, <port>) in SuperCollider, where <port> is the UDP port of the remote plugin. Currently there is no way to support multiple (SuperCollider) sessions without guessing the port number for the remote plugin. The :SCNvimStatusLine command ensures that SuperCollider always connects to the correct port.

But if you mostly use single sessions, and know that the port is likely to be available, you could probably add this to your startup.scd to automatically call the function on server boot.

// scnvim
if (\SCNvim.asClass.notNil) {
    Server.default.doWhenBooted {
        \SCNvim.asClass.updateStatusLine(1, 9670);
    }
}

Mappings

Map	Description	Name	Mode
`<C-e>`	Send current block or line (depending on context)	`<Plug>(scnvim-send-block)`	Insert, Normal
`<C-e>`	Send current selection	`<Plug>(scnvim-send-selection)`	Visual
`<M-e>`	Send current line	`<Plug>(scnvim-send-line)`	Insert, Normal
`<F12>`	Hard stop	`<Plug>(scnvim-hard-stop)`	Insert, Normal
`<CR>`	Toggle post window buffer	`<Plug>(scnvim-postwindow-toggle)`	Insert, Normal
`<M-L>`	Clear post window buffer	`<Plug>(scnvim-postwindow-clear)`	Insert, Normal
`K`	Open documentation	Uses vim `keywordprg`	Normal

To remap any of the default mappings use the nmap command together with the name of the mapping.

E.g. nmap <F5> <Plug>(scnvim-send-block)

To disable all default mappings specify let g:scnvim_no_mappings = 1 in your vimrc/init.vim

Commands

Command	Description
`SCNvimStart`	Start SuperCollider
`SCNvimStop`	Stop SuperCollider
`SCNvimRecompile`	Recompile SCClassLibrary
`SCNvimTags`	Create auto-generated utility files
`SCNvimHelp <subject>`	Open HelpBrowser for <subject>
`SCNvimStatusLine`	Display server status in status line

Configuration

The following variables are used to configure scnvim. This plugin should work out-of-the-box so it is not necessary to set them if you are happy with the defaults.

Run :checkhealth to diagnose common problems with your config.

Post window

" vertical 'v' or horizontal 'h' split
let g:scnvim_postwin_orientation = 'v'

" position of the post window 'right' or 'left'
let g:scnvim_postwin_direction = 'right'

" default is half the terminal size for vertical and a third for horizontal
let g:scnvim_postwin_size = 25

" automatically open post window on a SuperCollider error
let g:scnvim_postwin_auto_toggle = 1

Eval flash

" duration of the highlight
let g:scnvim_eval_flash_duration = 100

" number of flashes. A value of 0 disables this feature.
let g:scnvim_eval_flash_repeats = 2

" configure the color
highlight SCNvimEval guifg=black guibg=white ctermfg=black ctermbg=white

Extras

" path to the sclang executable
" scnvim will look in some known locations for sclang, but if it can't find it use this variable instead
" (also improves startup time slightly)
let g:scnvim_sclang_executable = ''

" update rate for server info in status line (seconds)
" (don't set this to low or vim will get slow)
let g:scnvim_statusline_interval = 1

" set this variable if you don't want the "echo args" feature
let g:scnvim_echo_args = 0

" UDP port for (remote) python plugin
let g:scnvim_udp_port = 9670

" set this variable if you don't want any default mappings
let g:scnvim_no_mappings = 1

" set this variable to browse SuperCollider documentation in nvim (requires `pandoc`)
let g:scnvim_scdoc = 1

Example configuration

This is not a recommended configuration but rather a way to show how a minimal init.vim could look to configure the plugin.

" vim-plug
call plug#begin('path/to/plugin/directory')
  Plug 'davidgranstrom/scnvim'
  " (optional) for snippets
  Plug 'SirVer/ultisnips'
call plug#end()

" scnvim
"
" post window at the bottom
let g:scnvim_postwin_orientation = 'h'

" remap send block
nmap <F5> <Plug>(scnvim-send-block)

" remap post window toggle
nmap <Space>o <Plug>(scnvim-postwindow-toggle)

" eval flash colors
highlight SCNvimEval guifg=black guibg=cyan ctermfg=black ctermbg=cyan
" this autocmd keeps the custom highlight when changing colorschemes
augroup scnvim_vimrc
  autocmd!
  autocmd ColorScheme *
        \ highlight SCNvimEval guifg=black guibg=cyan ctermfg=black ctermbg=cyan
augroup END

" hard coded path to sclang executable
let g:scnvim_sclang_executable = '~/bin/sclang'

" enable snippets support
let g:UltiSnipsSnippetDirectories = ['UltiSnips', 'scnvim-data']

" create a custom status line for supercollider buffers
function! s:set_sclang_statusline()
  setlocal stl=
  setlocal stl+=%f
  setlocal stl+=%=
  setlocal stl+=%(%l,%c%)
  setlocal stl+=\ \|
  setlocal stl+=%18.18{scnvim#statusline#server_status()}
endfunction

augroup scnvim_stl
  autocmd!
  autocmd FileType supercollider call <SID>set_sclang_statusline()
augroup END

" lightline.vim example
" let g:lightline = {}
" let g:lightline.component_function = {
"   \ 'server_status': 'scnvim#statusline#server_status',
"   \ }
"
" function! s:set_sclang_lightline_stl()
"   let g:lightline.active = {
"   \ 'left':  [ [ 'mode', 'paste' ],
"   \          [ 'readonly', 'filename', 'modified' ] ],
"   \ 'right': [ [ 'lineinfo' ],
"   \            [ 'percent' ],
"   \            [ 'server_status'] ]
"   \ }
" endfunction

Thanks to

scvim

vim-tidal

License

scnvim - SuperCollider integration for Neovim
Copyright © 2018-2019 David Granström

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

cdbzb/scnvim

scnvim

Note

Features

Showcase

Post window displayed in a regular vim buffer

Interactive argument hints in the command-line area

Status line widgets

Snippet generator

Installation

Requirements

Installation

Remote plugin

Syntax highlighting

Snippets

Status line widgets

Mappings

Commands

Configuration

Post window

Eval flash

Extras

Example configuration

Thanks to

License