Trimmer

Trimmer is a Sublime Text plug-in for cleaning up whitespace.

Features

• Trim whitespace at the end of each line.
• Trim whitespace at the start of each line.
• Trim whitespace at the start and end of each line.
• Delete empty, whitespace only lines.
• Collapse multiple consecutive empty lines into one empty line.
• Collapse multiple consecutive spaces into one space.
• Trim empty, whitespace only lines at the beginning and end of the file.
• Remove blank space characters.

Additional Features

A Replace Smart Characters command that performs the following actions:

• Smart single quotes: ’‘ to ''
• Smart double quotes: “” to ""
• Ellipsis: … to ...
• Em dash: — to ---
• En dash: – to --
• Middle dot: • to *
• Bullet: · to -
• Non-breaking space to space

Watch a Quick Demo

Install

Trimmer is compatible with Sublime Text 2 and 3, on all supported Operating Systems (OS X, Windows and Linux).

Package Control

The easiest, and recommended way to install Trimmer is using Package Control.

From the main application menu, navigate to:

• Tools -> Command Palette... -> Package Control: Install Package, type the word Trimmer, then select it to complete install.

Git

To install Trimmer using Git, change to your Sublime Text Packages directory, and clone the Trimmer repository.

For example, in OS X, start a Terminal session and enter the following two commands:

$ cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/
$ git clone https://github.com/jonlabelle/Trimmer

Manually

Download and extract the zip or tarball to your Sublime Text packages directory.

Here's the default Sublime Text Packages paths by OS.

OS X

~/Library/Application Support/Sublime Text [2|3]/Packages

Linux

~/.Sublime Text [2|3]/Packages

Windows

%APPDATA%/Sublime Text [2|3]/Packages

Don't forget to replace the [2|3] part with the appropriate Sublime Text version for your installation.

Usage

All commands are accessible from the Command Palette using prefix Trimmer, and in the Main Menu under Edit -> Line -> Trimmer command.

• Command Palette screenshot
• Main Menu screenshot

Key Bindings

The default key binding will trim trailing whitespace at the end of each of line (entire file).

• OS X: Ctrl + S
• Linux: Ctrl + Alt + S
• Windows: Ctrl + Alt + S

Trimmer Command API

Command	Description	Context
trimmer	trim whitespace at the end of each line	entire file
trim_leading_whitespace	trim whitespace at the start of each line	selection, or entire file
trim_leading_trailing_whitespace	trim whitespace at the start and end of each line	selection, or entire file
delete_empty_lines	delete empty, whitespace only lines	selection, or entire file
collapse_lines	collapse multiple consecutive empty lines into one empty line	selection, or entire file
collapse_spaces	collapse multiple consecutive spaces into one space	selection, or entire file
trim_edges	trim empty, whitespace only lines at the beginning and end of the file	entire file
remove_blank_spaces	remove all blank space characters (tab, cr, ff, vt, space)	selection, or entire file
replace_smart_characters	replace smart characters (smart quotes, em/en dash, ellipsis, nbsp)	entire file

Author

Jon LaBelle

License

Trimmer is licensed under the MIT license.