A simple static site generator written in Bash. Processes Markdown files and builds a minimal, accessible website suitable for personal journals, daily writing, or introspective personal newspapers. Started in 2015 by Stefano Marinelli as a personal project and maintained privately for many years, it has grown to become what is likely the largest static site generator written in Bash. Customizable URLs. Generates menus based on pages, distinguishing primary/secondary pages (via secondary: true). Creates a separate pages.html index for secondary pages. Automatically creates tag index pages and archives by year and month (optional) for easy browsing. Generates sitemap.xml and RSS feed (with timezone support) for content discovery and syndication. Test your site locally with the integrated development server that automatically adjusts URLs for local preview.
Has a modern, Ghost-like, browser-based editor with live preview, auto-save, Unsplash integration, and offline capability if writing raw Markdown isn't an option. Looking at the demo page it looks like the editor is just some hand written Javascript in an HTML file (bssg-editor.html), which I think you could break out and self host if you wanted. Choose from over 50 built-in themes including modern, retro computing, OS-inspired, and more; they seem to be just single CSS files.
Byobu is an open source text-based window manager and terminal multiplexer. It was originally designed to provide elegant enhancements to the otherwise functional, plain, and practical GNU Screen for Ubuntu. Byobu now includes enhanced profiles, convenient keybindings, configuration utilities, and toggle-able system status notifications for both Screen and the more modern Tmux, and works on most Linux, BSD, and Mac distributions.
Lazy-loading webcomponent, styles & fonts. Vector, raster, satellite & terrain tiles. Automatically localized. Automatic attribution & attribution-less alternatives. Hosted in the EU with no tracking. Open source, hosted & easily self-hostable. Data updated monthly.
Github: https://github.com/maps-black/maps.black
NOTE: Building the entire dataset from scratch will use about 5TB and take 14-20 days on a somewhat beefy machine (64-128GB RAM and a good CPU).
It looks like you can download the tilesets you need without having to build them yourself but I don't know how difficult that would be yet. A minimal tileset is about 100 megs. A basic OpenStreetmap tileset is about 100 gigs.
A 6502 emulator written in busybox ash. 6502.sh has a whopping 32k of RAM and 16k ROM in its default configuration, however this can be easily adjusted by editing machine.sh. It includes an interactive debugger with single-stepping, breakpoints (break on code, data access, JSR/RTS), and more. STDIO is directed to an ACIA compatible serial port at $8400 allowing for programs like BASIC to run.
A gamified self-discovering documentation system that transforms traditional network documentation into an immersive mystery adventure.
Network Chronicles revolutionizes technical documentation by transforming it from a passive reading experience into an interactive adventure. By embedding critical infrastructure knowledge within an engaging narrative framework, it addresses the fundamental challenge of IT documentation: making it compelling enough that people actually want to engage with it.
Players assume the role of a new system administrator tasked with maintaining a network after the mysterious disappearance of their predecessor, known only as "The Architect." Through exploration, puzzle-solving, and documentation, players uncover both the network's secrets and the truth behind The Architect's vanishing.
Run on Linux or OSX. Written for bash and zsh. Requires jq; node.js is optional but provides advanced features.
Can be installed system-wide (as root) or isolated to a user (without additional privileges).
A bit of glue between components that is able to textually summarize videos and podcasts - offline. The script takes a URL as argument, downloads and extracts the audio, transcribes the spoken words to text and then finally prints a summary of the content. No external services are used by this script except for the initial audio download. Examples of URLs that work are Youtube videos and Apple podcasts, see the yt-dlp project for the full list.
This script doesn't do anything clever, it just makes use of the great work done by other projects. Since the purpose is to not have to sit through 8-12 minutes of someone explaining what should've just been a short blog post. The default model used is LLaMa-3 to support medium spec hardware. If you have a large system, Mixtral 8x7b is another great option with a much larger context window (= able to work with longer transcriptions).
The script saves transcriptions to a folder in the same directory, and if the same URL is later used again it will not re-download the audio and create a new transcription but use the existing one. This means it's possible to later use the conversational mode to ask questions on the content, even if not done the first time.
Relies upon a locally hosted LLM to do the heavy lifting so you don't have to ship the data off to another service. Entirely self hosted.
Audiocat is a command-line utility for Linux that reads and writes encrypted data across peer-to-peer or broadcast audio connections, using minimodem and gpg.
It is a powerful tool that can be combined with any audio infrastructure (like PSTN, cellular network, internet, radio, walkie-talkies) to provide a secure communication channel through an audio tunnel.
The audio interfaces behave like data-diodes, each allowing unidirectional data transmission only, thus preventing data-leaks and malware-injection.
This enables an "enhanced"-end-to-end encryption (E-E2EE) which notably increases security and privacy, especially when the end devices are completely offline (air-gapped-system), thus providing an effective barrier against "legal or illegal" client-side-scanning!
A shell script to automate the setup of Linux router for IoT device traffic analysis and SSL MITM. It looks like it assumes that you're running it on an OpenWRT device (but I could be wrong).
Keychain helps you to manage SSH and GPG keys in a convenient and secure manner. It acts as a frontend to ssh-agent and ssh-add, but allows you to easily have one long running ssh-agent process per system, rather than the norm of one ssh-agent per login session.
This dramatically reduces the number of times you need to enter your passphrase. With keychain, you only need to enter a passphrase once every time your local machine is rebooted. Keychain also makes it easy for remote cron jobs to securely "hook in" to a long-running ssh-agent process, allowing your scripts to take advantage of key-based logins.
If your workflow is such that you have one terminal window but multiple tabs, this will fix quite a few annoyances.
Github: https://github.com/funtoo/keychain
Works very well on Linux, I've been using it for years. Also works on OSX; it's in Homebrew.
This repository helps to setup a ready-to-use chatmail server comprised of a minimal setup of the battle-tested postfix smtp and dovecot imap services. The setup is designed and optimized for providing chatmail accounts for use by Delta Chat apps. Chatmail accounts are automatically created by a first login, after which the initially specified password is required for using them.
This project is about delivering a ready-to-use IT infrastructure suitable for bootstrapping a small company, all self-hosted and supported by Open Source. The initial target platform is for a NetBSD/EdgeBSD NVMM hypervisor and a collection of guest VMs, with the software deployed with pkgsrc.
Stands up an OpenLDAP server, BIND for DNS, e-mail infrastructure (including webmail), Nextcloud, Gitea, Jitsi Meet, and a public website by running a handful of commands on a blank machine.
A couple of scripts that wrap git and generate short commit IDs that are linear, i.e., they start at 0000000, then 0000001, 0000002, and so forth.
It's kind of a useless hack but silly.
A a highly flexible, customizable, fast and powerful status bar replacement for people that like playing with shell scripts. The main design principle of this project is that all elements of the bar can be added, removed and freely changed at any point in time. Thus, the configuration of the bar is not static, rather it is possible to adapt the appearance of the bar completely dynamically with the help of a powerful event-driven scripting system at any point in time using the highly configurable basic building blocks SketchyBar offers.
The official documentation says to use Homebrew to install it.
Haserl is a small program that uses shell or Lua script to create cgi web scripts. It is intended for environments where PHP or ruby are too big. It was written for Linux, but is known to run on FreeBSD. A typical use is to run cgi scripts in an embedded environment, using a small web server, such as mini-httpd, lighty, or the server built into busybox.
he haserl binary typically compiles to less than 20KB (stripped). The lua language adds less than 150K if linked in statically. Parses like other scripting languages: Anything that is not enclosed in <% ... %> tags is sent verbatim to the client. Form elements sent from the client are automatically parsed and placed into environment variables. The script can then reference the variables without any extra work. Mime data sent via the enctype="multipart/form-data" method is transparently decoded. This method is used when uploading files from the client. Attempts to drop its privileges to the uid/gid of the owner of the script for security.
The Haserl Framework is a set of shell scripts and functions that allow one to build MVC-style web applications based on shell scripting and haserl templating. It is similar to Ruby's Sinatra framework in structure, functionality, and spirit. Haserl Framework is developed primarily for embedded systems running minimal Linux distributions with limited space and shell functionality. The framework itself is relatively bare-bones but can easily be extended.
Effort has be made to keep the framework as POSIX compliant as possible, but that is an ongoing pursuit. The original development platform for Haserl Framework was OpenWRT's Ash/Busybox shell.
Has its own DSL (domain-specific language) but it's shell-based. Uses either scgi requests or FIFO files. Request processing is done in subshells for isolation. Requires Haserl, socat, gpg, base64, and a web server that supports CGI or SCGI.
Microsoft's own de-bloating script for Windows.
This script will generate folders for each book, chapter, and page of a Bookstack install and writes them out as PDFs or HTML pages.
If you would export attachments from pages to, this script has to run on the same host as bookstackapp-wiki, because it reads files from the webservers docroot upload directory.
Library for embedding inline assembly directly inside bash. This is sheer madness - it injects machine code (assembled assembly language) directly into /proc/$$/mem for execution. Currently only supports x86-64.
A super-tiny Activitypub semi compliant microblogging platform, written entirely in bash. Requires netcat to provide network connectivity, openssl, jq, and curl. No front-end, no client-to-server. Everything is manual.
I'm not sure what you'd call this; there's no actual server, there's no API...
Dehydrated is a client for signing certificates with an ACME-server (e.g. Let's Encrypt) implemented as a relatively simple (zsh-compatible) bash-script. This client supports both ACME v1 and the new ACME v2 including support for wildcard certificates! It uses the openssl utility for everything related to actually handling keys and certificates, so you need to have that installed. Other dependencies are: cURL, sed, grep, awk, mktemp (all found pre-installed on almost any system, cURL being the only exception).
Current features:
- Signing of a list of domains (including wildcard domains!)
- Signing of a custom CSR (either standalone or completely automated using hooks!)
- Renewal if a certificate is about to expire or defined set of domains changed
- Certificate revocation
- and lots more.
Generally you want to set up your WELLKNOWN path first, and then fill in domains.txt. Please note that you should use the staging URL when experimenting with this script to not hit Let's Encrypt's rate limits. See docs/staging.md.