diego-ivan/kleroterion

Make randomization easy. A fork of ForeverXML's Random

Kleroterion

Make randomization easy

More screenshots

🎰 Uses

• Choose what to do for a date
• Play a number-guess game
• Choose between coffee or tea
• For science!

📩 Download Random!

Download it from Flathub by clicking the really big button above.

👩‍💻️ Techy stuff

Show the techy stuff

📲 Another way to download

Head on over to the Releases page and grab the latest Flatpak, then install it.

📝 A note

You can get it through the user-submitted AUR repo, but that will usually be out of date. The method I support the most is Flathub/Flatpak.

🛠️ Building Random

Flatpak

Clone this repo on GNOME Builder >= 3.28, open it, and click the Build button.

Native / Host

Clone this repo, and in the cloned directory run these commands:

meson _build --prefix=/usr && cd _build
sudo ninja install

You will need to install:

gdk-pixbuf2
glib2
gtk4
libadwaita
appstream-glib
meson
vala

Windows

I don't support anything but Flatpak. You will have to run this app through WSL, although Windows is such a privacy nightmare I do not support WSL. The app may be broken on Windows too. My reccomendation is to use this app on GNOME *NIX systems.

🌐 Translating Random

Check out the po folder.

🛣️ Roadmap for Random

• GNOME GitLab mirror
• GitHub mirror Ewww, GitHub? No thanks.
• Copy result keyboard shortcut and menu item
• Working translations (thanks to teackot and dimmednerd)
• More translations

Roadmap for 1.1 - 1.2

• Move Randomization functionality to different file
• random: links

Unimportant

• Windows package (LTS)

👩‍💻️ How to contribute to Random

Contributing

🚀 A starting guide

• Make a PR (or message me on Matrix) adding yourself to the Contributors section in this README.
• Next, here are some things I will label as wontfix.
  • Anything against GNOME HIG
  • Something too advanced for this simple app And don't forget to test before your PR! Have a great day.

🤓 EditorConfig

Make sure to follow the EditorConfig guidelines specified in the .editorconfig file. And check the EditorConfig website to see if your IDE is compatible!

😖 I don't have a Codeberg account...

No worries! Contact me on Matrix and we'll work it out.

🤝 Conduct

This project follows the GNOME Code of Conduct.

🖥️ Supported OS?

Long thing about OS support

🐧 Linux

Already supported; this is the main support!

🪟 Windows

Not for right now. Check the Roadmap for details on Windows support. And if you do want Windows, get ready to build it yourself.

🍏 MacOS and/or iOS

No, never. I am against all Apple platforms, and Random will never have a Mac package. I don't think GTK is supported on iOS either, though.

🤖 Android

GTK isn't supported yet, but I would publish on F-Droid.

💸 Donations

I am well off and do not need donations. Instead, donate to trans people in need.

kleroterion's Issues

New icons for Kleroterion

Maintenance Chores

There's a bunch of things I have pending in order to post this app in Flathub:

• #2
• The Roulette List should use Adw.EntryRow instead of our implementation
• Rename files so we have a more consistent naming approach
• Get rid of the CSS. We can figure its uses using margin properties in GTK

This are chores from Random's previous application to the GNOME Circle (https://gitlab.gnome.org/Teams/Circle/-/issues/94)

• Placeholder row for the Roulette page (we can do something similar to Paper Clip's own placeholder row for KeywordList, as they both use ListBoxes with ListModels)
• Add a new row when pressing enter