The Unhinged Librarian

Librarian Terminal Pack

The Librarian Terminal Pack is a small set of practical notes and guides that help you feel comfortable using the terminal just enough to run tiny, useful scripts (like the Library Pop-Up Tools). No deep technical background required.

~ % cd ~/Desktop/library_pop_up_tools
library_pop_up_tools % python catalog_cleaner.py my_catalog.csv cleaned_catalog.csv
Cleaned file written to: cleaned_catalog.csv
library_pop_up_tools % python suspicious_books_screener.py sample_books.csv sample_books_with_flags.csv
Screened 4 books.
Score 0: 2 titles
Score 3: 2 titles
Flagged file written to: sample_books_with_flags.csv

How to Use These Tools

  1. Start with the overview: open 00_README_FIRST.txt in any text editor. It explains what the pack is for and how to move through it.
  2. Learn a handful of commands: skim 01_SixCommands.txt and 02_OneLiners.txt to see a few commands you can copy and paste.
  3. Keep 06_CommonErrors.txt nearby so error messages feel less scary and you have quick “what does this mean?” answers.
  4. When you’re ready to “do a thing”: switch over to the library_pop_up_tools folder on your Desktop and run one script using what you learned.

The idea: read a little, try a tiny command, then use that confidence to run a pop-up tool (for example cleaning a catalog CSV or screening a vendor cart).

What’s Inside

Core files (read in order if you like)

Click any heading below to expand the full text in place (no extra tabs or windows).

Templates (for your own workshops)

Use these as starting points if you want to teach a short “terminal for librarians” session, build your own handouts, or adapt this pack for your staff and local workflows.

Connecting to the Library Pop-Up Tools

Once you’re comfortable with the basics here, you can move on to the pop-up tools that live in ~/Desktop/library_pop_up_tools:

  1. Open Terminal and run cd ~/Desktop/library_pop_up_tools.
  2. Pick one script from the tools page (for example catalog_cleaner.py or weeding_screener.py).
  3. Follow the “How to run it” instructions in that tool’s HTML page.

The Terminal Pack teaches you just enough to feel steady; the pop-up tools give you small, concrete wins in your day-to-day work.