vimgolf

This project contains a vimgolf client written in Python.

The user interface is similar to the official vimgolf client, with a few additions inspired by vimgolf-finder, and an optional way to specify keys to type when launching a challenge.

Installation

Requirements

Python 3.6 or greater

Install

$ pip3 install vimgolf

Update

$ pip3 install --upgrade vimgolf

Usage

Launch

If the launcher script was installed within a directory on your PATH, vimgolf can be launched directly.

$ vimgolf

Otherwise, vimgolf can be launched by passing its module name to Python.

$ python3 -m vimgolf

Commands

  vimgolf [help]                # display this help and exit
  vimgolf config [API_KEY]      # configure your VimGolf credentials
  vimgolf local IN OUT [KEYS]   # launch local challenge
  vimgolf put CHALLENGE [KEYS]  # launch vimgolf.com challenge
  vimgolf list [PAGE][:LIMIT]   # list vimgolf.com challenges
  vimgolf show CHALLENGE        # show vimgolf.com challenge
  vimgolf diff CHALLENGE        # show diff for vimgolf.com challenge
  vimgolf version               # display the version number

CHALLENGE can be a 24-character ID from vimgolf.com, or a plus-prefixed ID corresponding to the last invocation of vimgolf list. For example, a CHALLENGE of +6 would correspond to the sixth challenge presented in the most recent call to vimgolf list.

For the local command, IN and OUT are paths to files.

For the local and put commands, the optional KEYS specifies a set of keys to enter when launching the challenge. For example, ihello world<esc> would enter insert mode, type "hello world", and then switch back to normal mode. The character < is assumed to start a special sequence (e.g., <esc>) if that would be possible given the characters that follow. The input string should use <lt> to disambiguate.

Demo

License

The source code has an MIT License.

See LICENSE.

Release files for vimgolf 0.5.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vimgolf 0.5.4
File	Size	Uploaded
vimgolf-0.5.4.tar.gz	20.9 kB	May 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vimgolf 0.5.4
File	Interpreter	ABI	Platform	Reset
vimgolf-0.5.4-py3-none-any.whl 18.8 kB May 29, 2026	Python 3	none	any	Details

Total release size: 39.7 kB

Release files / vimgolf-0.5.4.tar.gz

Download URL	vimgolf-0.5.4.tar.gz
Size	20.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`13b0854a30218c837beb82f025abc550d64176d90223a1ea0c7aa29b708f612d`
BLAKE2b-256 checksum How to use checksums	`8717aaacfb9ead19b6114034ffe779fa2c5b3271e59422274f09a06a9624442e`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`

Release files / vimgolf-0.5.4-py3-none-any.whl

Download URL	vimgolf-0.5.4-py3-none-any.whl
Size	18.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a03639771d423b694dac1ebc5b18f5d716faace7164efb75758d6cc9a4d2f08a`
BLAKE2b-256 checksum How to use checksums	`1b7f3ed315cb631e52dc525ba2270c452e140a7593477f486ebe3d167daa3974`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`