NORDLICHT(1)

📦 version 0.4.5, in ubuntu jammy

💖 NORDLICHT 💖

okay so bestie, welcome to nordlicht(1) — a User Commands situation, and honestly? it's giving art. it's giving ✨cinema✨. this little icon creates colorful barcodes from video files, and no cap, it's one of the prettiest things a terminal can do for you. 🌈

🎀 NAME 🎀

nordlicht — creates colorful barcodes from video files. that's it, that's the whole vibe. 💅

🦋 SYNOPSIS 🦋

nordlicht [OPTION]... VIDEOFILE

so you hand it a video, you hand it some options if you're feeling spicy, and it hands you back a whole barcode. main character energy fr fr. 👑

✨ OPTIONS ✨

every single one of these is your bestie. they're all here, none skipped, periodt.

  • -w, --width=INT — sets the barcode's width. by default it's "height*10", or 1920 pixels if both are undefined (like, if you didn't tell it anything, it just picks 1920 for you 🫶).
  • -h, --height=INT — sets the barcode's height. by default it's "width/10".
  • -o, --output=FILENAME — sets the output filename. the default is VIDEOFILE.png. and okay listen: when you specify an *.bgra file, you'll get a raw 32-bit BGRA file that is updated as the barcode is generated. as in, it's literally live-updating while it works. obsessed. 😭
  • -s, --style=STYLE — default is 'horizontal', and there's a whole Styles section below for you. you can specify more than one style, separated by '+', to get multiple tracks. multiple tracks!! stacked!! iconic. 🔥
  • --start=FLOAT — specify where to start the barcode (ratio between 0 and 1).
  • --end=FLOAT — specify where to end the barcode (ratio between 0 and 1).
  • -q, --quiet — don't show progress indicator. for when you want the drama of silence. 💀
  • --help — display this help and exit.
  • --version — output version information and exit.

🌸 Styles: 🌸

pick your fighter, bestie.

  • horizontal — compress frames to vertical lines and append them.
  • vertical — compress frames to horizontal lines and rotate them counterclockwise by 90 degrees.
  • slitscan — take single columns while constantly moving to the right (and wrapping back to the left).
  • middlecolumn — take the middlemost column of each frame.
  • thumbnails — display small thumbnails at regular intervals.
  • spectrogram — spectrogram of the first audio track (not all sample formats are supported yet). ⚠️ heads up on that "yet", she's honest about her limits.

🧚 EXAMPLES 🧚

here's how the girlies actually run it:

nordlicht video.mp4

generate video.mp4.nordlicht.png of default size. easy. effortless. ✨

nordlicht video.mp4 -s vertical

compress individual frames to columns.

nordlicht video.mp4 -w 1000 -h 1000 -o barcode.png

override size and name of the output file. 1000 by 1000, square, cute, named barcode.png. slay. 💅

👑 AUTHOR 👑

Written by Sebastian Morr and contributors. 🫶

okay that's the whole page bestie, go make some barcodes. this was nordlicht version 0.4.5, from way back in September 2019 — still iconic, still eating. mwah. 💖🎀🦋

📦 where this page comes from