rfortune-0.2.2 is not a library.

Visit the last successful build: rfortune-0.5.5

🥠 rFortune

rFortune is a modern, cross-platform reimplementation of the classic Unix fortune program, written in Rust.

It displays a random quote or witty phrase from a plain text file, making it perfect for terminal startup messages, scripting, or just a bit of inspiration.

🚀 Features

✅ Cross-platform: works on Linux, Windows, macOS Intel and Apple Silicon
⚡ Fast and lightweight (native Rust binary)
📁 Simple input format: one or more lines per fortune, separated by %
🌹 UTF-8 support for multilingual content
🧩 Easily extensible
✨ Supports --file, --init, --version, and --help options

📦 Installation

🍺 Homebrew Tap for rFortune

This is the official Homebrew tap for rFortune, a fast and cross-platform clone of the classic UNIX fortune command, written in Rust.

Also, available on crates.io for installation via cargo install.

To install rfortune using Homebrew:

brew tap umpire274/rfortune
brew install rfortune

Then simply run:

rfortune

You’ll see a randomly selected quote from a classic-style fortune file.

🖥️ Supported Platforms

This tap provides precompiled binaries for:

✅ macOS (Intel - x86_64)
✅ macOS (Apple Silicon - arm64)
✅ Linux (x86_64) via Homebrew on Linux

The correct binary is automatically chosen based on your system architecture.

📥 Download

Precompiled binaries are available in the Releases section.

Platform	Architecture	File
Windows	x86_64	`rfortune-<version>-x86_64-pc-windows-msvc.zip`
Linux	x86_64	`rfortune-<version>-unknown-linux-gnu.tar.gz`
macOS Intel Architecture	x86_64	`rfortune-<version>-x86_64-apple-darwin.tar.gz`
macOS Apple Silicon	aarch64	`rfortune-<version>-aarch64-apple-darwin.tar.gz`

🔐 GPG Signature

All release archives are cryptographically signed with GPG.

.sig files contain the ASCII-armored detached signature for the corresponding archive.
You can verify the archive with:

gpg --verify rfortune-<version>-<target>.tar.gz.sig rfortune-<version>-<target>.tar.gz

🔑 Public Key

The releases are signed with the following GPG key:

Key ID: 423FABCE0A1921FB
Fingerprint: 8118 9716 9512 2A32 1F3D C04C 423F ABCE 0A19 21FB
Download: https://github.com/umpire274.gpg

To import the key from a keyserver:

gpg --recv-keys 423FABCE0A1921FB

Or from OpenPGP server:

gpg --keyserver keys.openpgp.org --recv-keys 423FABCE0A1921FB

Then verify the fingerprint:

gpg --fingerprint 423FABCE0A1921FB

🔐 Initialization (optional)

To create the default fortune directory and a starter rfortunes.dat file:

rfortune --init

On Linux/macOS: creates /usr/local/share/rfortune/rfortunes.dat
On Windows: creates %APPDATA%\rfortune\rfortunes.dat

🚀 Usage

rfortune [--file path/to/quotes.dat]

🧩 Options

Option	Description
`-f`, `--file`	Use a custom file of fortunes
`--init`	Create the default directory and test file
`-V`, `--version`	Show version
`-h`, `--help`	Show help message

If no file is specified, the program defaults to platform-specific location.

🧪 Example

$ rfortune
Never trust a computer you can't throw out a window. — Steve Wozniak

📁 File Format

Each fortune must be on one or more lines separated by '%', like so:

%
The best way to get a good idea is to get a lot of ideas.
%
Do or do not. There is no try.
%
To iterate is human, to recurse divine.
%

🔒 License

This project is licensed under the MIT License.

💡 Contributing

Pull requests are welcome! If you’d like to add support for more languages, improve performance, or fix bugs, feel free to fork the repo and contribute.

🙌 Acknowledgments

Inspired by the classic BSD fortune program. Built with ❤️ in Rust.

rfortune 0.2.2