Noodle

Input

Custom Wordlist
Send Feedback

This form will send @zbanks your current query, your browser name, and the above text.

Output

Noodle is a tool to find words or phrases that match certain conditions.

It’s similar to Regular Expressions, Nutrimatic, qhex Word Play, or Qat.

Quick Reference

Help

Basics

Specify filters in the input textbox. Each line is treated as a separate noodle expression; you can also fit multiple expressions on one line by separating them with a semicolon (;), which is useful when a text field doesn’t allow newlines (e.g. a spreadsheet formula). Only results that match all expressions are returned, so more lines/expressions means a more specific (and usually slower) query.

The query runs until one of the following:

New to Noodle? Start with a single word-shaped expression like .{5} or crossword, then layer on constraints (anagram banks, enumerations, fuzzy matching) one at a time – each additional line narrows the results further, and it’s easier to tell which line is responsible for an unexpected (or missing) result if you add them incrementally.

Noodle Expressions

Regular Expressions

Noodle supports the following regular expression syntax: […], [^…], ., *, +, ?, (…), |, {…}.

Before matching, words are converted to lowercase and stripped of whitespace and non-alphabetical symbols (punctuation, numbers).

To explicitly match spaces, include “!_” at the end of the expression. When enabled, spaces can be explicitly matched with the “_” character.

To explicitly match other symbols, include “!'” at the end of the expression. When enabled, these symbols can be matched with the “'” character.

Regardless of setting, and unlike normal regular expressions, the period (“.”) is only equivalent to “[a-z]”. To match any symbol, use “[a-z'_]”.

Noodle expressions do not support backreferences (e.g. “\1”). Additionally, because the input is pre-processed to have a limited alphabet, noodle expressions do not support escape characters, or character classes like “[:alpha:]”.

Anagram constraints

Noodle has additional support for anagram-like constraints with angle bracket syntax: <...>

The <...> forms only accept a literal bank of letters (e.g. <abcd>, not <(ab|cd)>) – for these, order doesn’t matter at all, only which letters are available. The (...:-), (...:+), and (...:^) forms instead accept a nested expression (letters, [classes], (groups), etc.) and preserve its order, just allowing letters to be skipped, inserted, or restricted to a contiguous run, respectively.

Anagram constraints are not compatible with fuzzy matching, and may result in false positives (but not false negatives!).

Enumerations

Bare numbers are a shortcut to define an enumeration.

The expression 3 3 8 7 looks for a 4-word phrase, consisting of two 3-letter words, followed by an 8-letter word, then a 7-letter word.

Fuzzy matching

Noodle supports performing fuzzy matching for certain expressions.

This will find words & phrases that would match within a given edit distance of the expression.

To allow matches within edit distance 2, include “!2” at the end of the expression.

Fuzzy matching can make queries take much longer, so it works best when there are additional constraints.

Fuzzy Caveats

If there are multiple constraints with fuzzy matching, the edits between expressions may not be consistent. For example, "hey" will match the query "hen !1; hay !1" even though the edits to get to “hen” or “hay” are different.

Anagram-like constraints (“<…>”) are incompatible with fuzzy matching, and may produce false positives.

Macros

Macros allow you to define a common subexpression, which can be useful when working with repeated letters from a letterbank.

Macros are defined with NAME=expression... syntax on their own lines.

Macros are substituted in later lines before parsing, using a naive find-replace in the order they are defined.

Useful Macros

Pragmas

Pragmas are query-wide options, written as their own line starting with #. Unlike expressions, a pragma doesn’t filter results itself – it changes how the whole query runs. They’re what the Query Controls in the UI actually add to your query behind the scenes, so you usually don’t need to type them by hand unless you’re scripting queries (e.g. the Google Sheets Integration) or want a query that’s reproducible as plain text.

UI Tips

Keyboard shortcuts

Query Controls

The controls above the input textbox set query-wide options without needing to type a pragma by hand:

Next to each result, there are 3 links to common actions:

Google Sheets Integration

You can query Noodle directly from Google Sheets! Here’s an example formula:

=IMPORTDATA(CONCAT("https://noodle.fly.dev/query/", ENCODEURL("yourqueryhere")))

You can wrap it in TRANSPOSE(...) to have it fill out horizontally instead of vertically.

Since a formula’s query argument is a single string, use ; (not a newline) to separate multiple expressions – see Basics.

This plaintext GET endpoint has a shorter 10 second timeout, and defaults to only 15 results; raise the latter with the #limit pragma, e.g. #limit 100;<abcd+>.

Wordlist

The input wordlists are described below, and can be downloaded by following these links:

It is based on the Debian wordlist, Wikipedia, and Wiktionary.

Learn More

Noodle is open-source and released under the MIT license.

Visit GitHub to fork the code or submit bugs. There is also a command-line version available for running offline/locally.

Similar Tools