aaronsegura / letterboxed

Python module and CLI utility to solve NYT Letterboxed game in two or fewer words.

Letterboxed Solver

Python module to solve the daily word puzzle from the New York Times.

Installation

python -mpip install letterboxed

Usage

You will need a local dictionary file in order to use this module if you want to specify custom puzzles with the -l argument.

$ letterboxed -h
usage: letterboxed [-h] (-n | -l top-rgt-lft-btm | -r) [-d <file>] [-g word1,word2]

NYT Letterboxed Solver

options:
-h, --help          show this help message and exit
-n                  Pull today's puzzle from the NYTimes website.
-l top-rgt-lft-btm  Specify the letters you want on the box.
-r                  Generate a random letterbox puzzle.
-d <file>           Dictionary File
-g word1,word2      Make a guess on the supplied letterbox.

# Puzzle for December 8, 2023
$ letterboxed -d /usr/share/dict/american-english -l CTO-UFM-QZB-INA -d /usr/share/dict/american-english-huge
quiz -> zombification

$ letterboxed -n

Today's puzzle is CTO-UFM-QZB-INA

quiz -> zombification
quoz -> zombification

$ letterboxed -l CTO-UFM-QZB-INA -g quiz,zombification -d /usr/share/dict/american-english-huge
You got it!

$ letterboxed -r -d /usr/share/dict/american-english
Your letterbox puzzle is

        vdi-tsn-aeo-mrl

Run `letterboxed -l vdi-tsn-aeo-mrl -g your,guess` to make a guess.

Example python module usage:

from letterboxed import Letterbox

with open("/usr/share/dict/american-english-small", "r") as fp:
    dict = fp.read().split("\n")

lbox = Letterbox((('a', 'e', 'g'), ('h','i','l'), ('c', 'm', 'v'), ('p', 'o', 't')), dict)

for pair in lbox.solve():
    print(" -> ".join(pair))