Text Filters

From BBEditExtras
Jump to: navigation, search

Text filters operate on the selected text of the frontmost document (or on the whole document if there is no selection).

The selection will be replaced with the filtered text (or the whole document if there is no selection).

A text filter may be a Unix script, AppleScript file, BBEdit Text Factory, or Automator workflow.

Text filter folder path:

    ~/Library/Application Support/BBEdit/Text Filters

To use a Text Filter, select Menu_Bar > Text > Apply Text Filter > your_filter_name

To easily edit a text filter hold down the Option-key when selecting one from the “Apply Text Filter” menu.

Holding down the Shift-key when selecting a text filter will reveal it in the Finder.

NOTES:

The selected text (or front document contents, if there is no selection) is passed as `argv[1]` to Unix executables, as a string to text factories, as a reference to a `RunFromBBEdit` entry point in AppleScripts, as text input to Automator workflows, and as a source to text factories.

Starting with BBEdit 10.1, text input is passed to Unix executables via `stdin`, not `argv[0]`.

EXAMPLES:

Transform tab-delimited text into columns:

#!/usr/bin/env bash
column -t -s '	';

Change “http” to https in URLs:

#!/usr/bin/env bash
sed -E 's!http://!https://!';

Find Every Email Address - Sort - Remove Duplicates:

#! /usr/bin/env perl -0777 -nsw
my @array = m!\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}\b!ig;
my %hash = map { $_ => 1 } @array;
my @unique = sort(keys %hash);
$, = "\n";
print @unique;

User created Text Filters