{"id":29008489,"url":"https://github.com/zquestz/fortunate","last_synced_at":"2025-08-26T22:15:40.453Z","repository":{"id":261341839,"uuid":"883980402","full_name":"zquestz/fortunate","owner":"zquestz","description":"A beautiful motivation/fortune app for Linux and macOS.","archived":false,"fork":false,"pushed_at":"2025-05-10T04:08:19.000Z","size":162,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-19T15:54:46.081Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zquestz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["zquestz"]}},"created_at":"2024-11-05T23:17:52.000Z","updated_at":"2025-05-10T04:08:00.000Z","dependencies_parsed_at":"2024-11-21T02:27:07.866Z","dependency_job_id":"30f0eac6-8afd-4581-b628-d838eb5a6f48","html_url":"https://github.com/zquestz/fortunate","commit_stats":null,"previous_names":["zquestz/fortunate"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/zquestz/fortunate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zquestz%2Ffortunate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zquestz%2Ffortunate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zquestz%2Ffortunate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zquestz%2Ffortunate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zquestz","download_url":"https://codeload.github.com/zquestz/fortunate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zquestz%2Ffortunate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261888111,"owners_count":23225143,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-25T14:06:02.931Z","updated_at":"2025-08-26T22:15:40.443Z","avatar_url":"https://github.com/zquestz.png","language":"Go","funding_links":["https://github.com/sponsors/zquestz"],"categories":[],"sub_categories":[],"readme":"![Fortunate](fortunate.png)\n\n# Fortunate\n\n[![License][License-Image]][License-URL] [![ReportCard][ReportCard-Image]][ReportCard-URL] [![Build][Build-Status-Image]][Build-Status-URL] [![Release][Release-Image]][Release-URL]\n\n**Fortunate** is an open-source motivational app for Linux and macOS 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.\n\n![Screenshot](screenshot.png)\n\n## Table of Contents\n\n- [Features](#features)\n- [Package Install](#package-install)\n- [Source Build/Install](#source-buildinstall)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [Custom Fortune Collections](#custom-fortune-collections)\n- [License](#license)\n- [Acknowledgments](#acknowledgments)\n\n## Features\n\n- **Dual Display Modes**:\n  - Beautiful graphical window for focused inspiration\n  - Unobtrusive system notifications for passive motivation\n- **Customizable Experience**:\n  - Choose from classic fortune collections\n  - Configure notification frequency and display preferences\n  - Select specific fortune databases to match your mood\n- **Modern Interface**: Clean and intuitive design powered by the Fyne GUI toolkit\n- **System Integration**: Runs seamlessly in your system tray with dark/light theme support\n- **Resource Efficient**: Written in Go for minimal system impact\n\n## Package Install\n\n**Arch Linux**\n\n```bash\nyay -S fortunate\n```\n\n## Source Build/Install\n\n### Dependencies\n\n**Arch Linux**\n\n```bash\nsudo pacman -S git make go gcc pkg-config xorg-server-devel libxcursor libxrandr libxinerama libxi fortune-mod\n```\n\n**Debian/Ubuntu**\n\n```bash\nsudo apt-get install git make golang gcc libgl1-mesa-dev xorg-dev fortune-mod\n```\n\n**Fedora**\n\n```bash\nsudo dnf install git make golang gcc libXcursor-devel libXrandr-devel mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm-devel fortune-mod\n```\n\n**macOS**\n\nFirst install XCode and then execute:\n\n```bash\nbrew install golang fortune\n```\n\n### Build and Install\n\n```bash\n# Clone the repository\ngit clone https://github.com/zquestz/fortunate\n\n# Change to project directory\ncd fortunate\n\n# Build the project\nmake\n\n# Linux Install\nsudo make install\n\n# macOS Install\nmake install-darwin\n```\n\n## Usage\n\n### Basic Usage\n\n- Launch Fortunate from your applications menu or run `fortunate` in your terminal\n- The application runs in your system tray or menubar (look for the lotus icon)\n\n**System Tray**\n\n- Left-click the tray icon to display a fortune\n- Right-click the tray icon to access the menu:\n  - Display Fortune\n  - Notify Fortune\n  - Settings\n  - About\n  - Quit\n\n**Menubar**\n\n- Click the menubar icon to access the menu:\n  - Display Fortune\n  - Notify Fortune\n  - Settings\n  - About\n  - Quit\n\n### Command Line Options\n\n```pre\nfortunate [flags]\n\nFlags:\n  -h, --help      help for fortunate\n      --version   display version\n```\n\n## Configuration\n\nFortunate can be customized through the settings window, accessible from the tray icon:\n\n### Settings Options\n\n- **Icon Theme**: Choose your preferred icon theme\n- **Fortune Timer**: Set how often fortunes appear as notifications\n- **Fortune Length**: Choose between Short and/or Long fortunes\n- **Show Cookie**: Toggle fortune cookie display\n- **Fortune Lists**: Select which fortune databases to use\n\n## Custom Fortune Collections\n\nThis repository includes additional custom fortune collections located in `fortunes/`. These collections offer inspiring and thoughtful quotes focused on different themes.\n\n### Available Collections\n\n- **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.\n\n- **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.\n\n- **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.\n\n### Installation\n\nThe fortune directory location varies by distribution:\n\n- Debian/Ubuntu/Fedora: `/usr/share/games/fortunes/`\n- Arch Linux: `/usr/share/fortune/`\n- macOS: `/usr/local/share/games/fortunes`\n\nCopy the fortune files to your system's fortune directory:\n\n```bash\n# For Debian/Ubuntu/Fedora\nsudo cp fortunes/* /usr/share/games/fortunes/\n\n# For Arch Linux\nsudo cp fortunes/* /usr/share/fortune/\n\n# For macOS\ncp fortunes/* /usr/local/share/games/fortunes/\nstrfile /usr/local/share/games/fortunes/appreciation\nstrfile /usr/local/share/games/fortunes/inspiration\nstrfile /usr/local/share/games/fortunes/motivation\n```\n\nNote: You may need to check your specific distribution's fortune directory location if it differs from these common paths.\n\n### Usage\n\nYou can display a random fortune from a specific collection:\n\n```bash\nfortune appreciation\nfortune inspiration\nfortune motivation\n```\n\nOr include them in the general rotation with other fortune files:\n\n```bash\nfortune all\n```\n\nThese collections aim to provide daily doses of wisdom, encouragement, and mindful reflection.\n\n## License\n\nFortunate is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Fyne](https://fyne.io/) - GUI toolkit\n- [fortune-mod](https://github.com/shlomif/fortune-mod) - Fortune database and utilities\n- [Lotus icons created by bearicons - Flaticon](https://www.flaticon.com/free-icons/lotus)\n\n[License-URL]: https://opensource.org/licenses/MIT\n[License-Image]: https://img.shields.io/npm/l/express.svg\n[ReportCard-URL]: https://goreportcard.com/report/zquestz/fortunate\n[ReportCard-Image]: https://goreportcard.com/badge/github.com/zquestz/fortunate\n[Build-Status-URL]: https://app.travis-ci.com/github/zquestz/fortunate\n[Build-Status-Image]: https://app.travis-ci.com/zquestz/fortunate.svg?branch=main\n[Release-URL]: https://github.com/zquestz/fortunate/releases/tag/v1.1.4\n[Release-Image]: https://img.shields.io/badge/release-v1.1.4-1eb0fc.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzquestz%2Ffortunate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzquestz%2Ffortunate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzquestz%2Ffortunate/lists"}