Search Scratch for unclaimed one-word usernames and sort from shortest to longest in length. Useful for namesnipers.
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-05-15 17:39:54 -05:00
hypersniper-refresh.py Add files via upload 2026-05-15 17:32:49 -05:00
hypersniper.py Update hypersniper.py 2026-05-15 17:05:17 -05:00
LICENSE Initial commit 2026-05-14 21:58:55 -05:00
README.md Update README.md 2026-05-15 17:39:54 -05:00

hypersniper

hypersniper downloads a list of words from dwyl/english-words and queries the Scratch API to find which ones are available usernames.

Disclaimer

hypersniper is NOT developed by the Scratch Team, nor is it affiliated with them in any way. Use it at your own risk.

Additionally, section 11.13 of the Scratch Terms of Service contains the following text:

[You shall not] automatically or programmatically extract any data of the Service, including Output

This would seem to imply that using hypersniper violates the ToS, but I haven't found any examples where this rule has actually been enforced.

Commands

hypersniper

Usage: python3 hypersniper.py <MIN> <MAX> <FILE> [FILTER], where <MIN> is the starting index for the word list, <MAX> is the end index, [FILTER] is an regex filter to apply to the usernames (default value if not specified is .*), and <FILE> is a file to write the finished newline-separated available usernames list to. If <FILE> already exists, hypersniper will assume that the entries within it are known to be available and will not check them.

Whenever hypersniper encounters a KeyboardInterrupt exception, it will save its results so far to the specified file before exiting.

hypersniper-refresh

hypersniper-refresh takes a list of usernames from hypersniper, checks that each one is still available and applies an optional regex filter, and then writes a new list containing the resulting entries.

Usage: python3 hypersniper-refresh.py <INPUT> <OUTPUT> [FILTER], where <INPUT> is the input file, <OUTPUT> is the output file, and [FILTER] is an optional regex filter (default value: .*), which is used to narrow down usernames before verifying them.

Notes

This project was originally created for The Great Codeoff, a programming competition started by @GraisonAtSchoolAgain from GitHub. LLMs were not used to write any of the final code.