devbits

A lightweight CLI toolkit for daily development utilities — video/image processing, project file management, and more.

Installation

pip install devbits

Requires Python ≥ 3.9.

Usage

All commands are available in two ways:

# As subcommands of devbits
devbits <command> [options]

# As standalone commands
<command> [options]

Use --help on any command for detailed usage and parameter descriptions:

devbits clipvideo --help
clipvideo --help

Commands

Video

Image

Project / Files

Network

Examples

# Trim video from 5s to 20s
clipvideo movie.mp4 --start 5.0 --end 20.0

# Open interactive clip editor in the browser
clipvideo movie.mp4 --gui

# Convert video to GIF (3.5s–10s at 15 fps)
video2gif movie.mp4 --start 3.5 --end 10.0 --fps 15

# Extract every 5th frame as PNG
video2images movie.mp4 --every 5 --format png

# Recolor a logo's foreground to black (keeps the background)
recolor logo.png

# Recolor a logo's foreground to a custom color (hex or R,G,B)
recolor logo.png --color '#1a73e8'
recolor logo.png --color 0,178,179

# Batch resize images to 800×600
batchimages ./photos -o ./resized --size 800,600

# Clean Python caches
clearcache . --all

# List every device on your local network
netscan

# Also identify each device's manufacturer (online OUI lookup)
netscan --lookup

# Scan a specific subnet, faster, without hostname lookups
netscan --network 192.168.1.0/24 --timeout 0.5 --no-resolve

# Show the Wi-Fi networks in range (Linux / Windows)
wifi list

# Pick a Wi-Fi network with the arrow keys, then type the password
wifi connect

# Join a specific network without the picker
wifi connect MyHome-5G

# Turn the Wi-Fi radio on / off
wifi on
wifi off

# Stop a network from auto-connecting
wifi forget OldCafe

netscan reports IP, MAC, hostname and (with --lookup) the hardware manufacturer — a network scan can't read a device's CPU/RAM/OS. Phones and laptops that use a randomized/private MAC show up as (private) and can't be attributed to a vendor.

Wi-Fi

wifi connect lists everything in range — move with ↑/↓, press Enter to join, Esc to cancel. The password prompt is hidden, skipped for open networks, and skipped again for networks your system already remembers. When stdout isn't a terminal the picker degrades to a numbered prompt, so the command still works over pipes and in scripts.

Each subcommand drives the platform's own tooling, so no extra dependency or driver access is needed:

Scanning support

--password exists for automation but lands in your shell history — prefer the interactive prompt. On Linux, NetworkManager itself takes the passphrase as a command-line argument, so it is briefly visible in the process list.

Linux: polkit and sudo

NetworkManager's polkit rules usually let a local desktop session toggle Wi-Fi without a password, but deny the same thing over SSH. When an operation is refused, wifi says so and re-runs just that nmcli command under sudo, which prompts for your password on the terminal:

Error: Failed to set radio: Not authorized to enable/disable WiFi.
Retrying with sudo (you may be asked for your password) ...

The escalation only happens on an interactive terminal. In a script or pipeline the command fails with the permission error instead of hanging on a prompt.

If you have a shell function or alias named wifi (a common nmcli wrapper), it takes precedence over this command — shell functions win over PATH. Use devbits wifi ..., or remove the function.

macOS: no scanning

wifi list is unsupported on macOS, and wifi connect without an SSID picks from the networks this Mac already remembers rather than what's in range:

$ devbits wifi connect
Listing nearby Wi-Fi networks is not supported on macOS. ...

Falling back to your saved networks.
Select a network to join:
❯ MyHome-5G                     (saved)
  CoffeeShop                    (saved)

Joining by name — wifi connect MyHome-5G — always works, as do on, off and forget.

The reason is that the last remaining macOS API that enumerates networks, system_profiler SPAirPortDataType, replaces every SSID with the literal string <redacted> unless the calling process holds Location Services authorization. That is a TCC privacy permission, not a file permission: sudo does not bypass it, the authorization database is SIP-protected, and a CLI cannot request it — only a bundled app linking CoreLocation can. Rather than ship a pyobjc dependency for one platform, devbits doesn't scan on macOS at all.

Output Defaults

When -o / --output is omitted, the output filename is derived from the input:

clipvideo movie.mp4          →  movie_clip.mp4
video2gif movie.mp4          →  movie.gif
resizeimage photo.jpg        →  photo_resized.jpg
recolor logo.png             →  logo_revised.png
contactsheet ./photos        →  photos_sheet.jpg

License

MIT