Fortunate

Fortunate is an open-source motivational app for Linux that delivers uplifting quotes and thoughtful messages. Powered by fortune-mod, it offers both a clean graphical interface and system notifications to keep you inspired throughout your day.

Table of Contents

• Features
• Build/Install
• Usage
• Configuration
• Custom Fortune Collections
• License
• Acknowledgments

Features

• Dual Display Modes:
  • Beautiful graphical window for focused inspiration
  • Unobtrusive system notifications for passive motivation
• Customizable Experience:
  • Choose from classic fortune collections
  • Configure notification frequency and display preferences
  • Select specific fortune databases to match your mood
• Modern Interface: Clean and intuitive design powered by the Fyne GUI toolkit
• System Integration: Runs seamlessly in your system tray with dark/light theme support
• Resource Efficient: Written in Go for minimal system impact

Build/Install from Source

Dependencies

Arch Linux

sudo pacman -S git make go gcc pkg-config xorg-server-devel libxcursor libxrandr libxinerama libxi fortune-mod

Debian/Ubuntu

sudo apt-get install git make golang gcc libgl1-mesa-dev xorg-dev fortune-mod

Fedora

sudo dnf install git make golang gcc libXcursor-devel libXrandr-devel mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm-devel fortune-mod

Build and Install

# Clone the repository
git clone https://github.com/zquestz/fortunate

# Change to project directory
cd fortunate

# Build the project
make

# Install system-wide
sudo make install

Usage

Basic Usage

• Launch Fortunate from your applications menu or run fortunate in your terminal
• The application runs in your system tray (look for the lotus icon)
• Right-click the tray icon to access the menu:
  • Display Fortune
  • Notify Fortune
  • Settings
  • About
  • Quit

Command Line Options

fortunate [flags]

Flags:
  -h, --help      help for fortunate
      --version   display version

Configuration

Fortunate can be customized through the settings window, accessible from the tray icon:

Settings Options

• Icon Theme: Choose your preferred icon theme
• Fortune Timer: Set how often fortunes appear as notifications
• Fortune Length: Choose between Short and/or Long fortunes
• Show Cookie: Toggle fortune cookie display
• Fortune Lists: Select which fortune databases to use

Custom Fortune Collections

This repository includes additional custom fortune collections located in fortunes/. These collections offer inspiring and thoughtful quotes focused on different themes.

Available Collections

• appreciation: A collection of quotes and thoughts about gratitude, mindfulness, and finding beauty in everyday moments. Features wisdom from various thinkers like Voltaire, Cicero, and John F. Kennedy.

• inspiration: Uplifting quotes and reflections about wonder, possibility, and the magic in everyday life. Includes thoughts from authors like C.S. Lewis, W.B. Yeats, and Alice Walker.

• motivation: Empowering quotes focused on personal growth, inner strength, and taking action. Features wisdom from leaders and thinkers like Viktor Frankl, Thich Nhat Hanh, and Eleanor Roosevelt.

Installation

The fortune directory location varies by distribution:

• Debian/Ubuntu/Fedora: /usr/share/games/fortunes/
• Arch Linux: /usr/share/fortune/

Copy the fortune files to your system's fortune directory:

# For Debian/Ubuntu/Fedora
sudo cp fortunes/* /usr/share/games/fortunes/

# For Arch Linux
sudo cp fortunes/* /usr/share/fortune/

Note: You may need to check your specific distribution's fortune directory location if it differs from these common paths.

Usage

You can display a random fortune from a specific collection:

fortune appreciation
fortune inspiration
fortune motivation

Or include them in the general rotation with other fortune files:

fortune all

These collections aim to provide daily doses of wisdom, encouragement, and mindful reflection.

License

Fortunate is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

• Fyne - GUI toolkit
• fortune-mod - Fortune database and utilities
• Lotus icons created by bearicons - Flaticon