Skip to content

samcday/phrog

Repository files navigation

🐸 (phrog)




A greeter that works on mobile devices and also other kinds of computers.

🤓 phrog uses Phosh to conduct a greetd conversation.

It is the spiritual successor of phog.


Usage

Alpine/postmarketOS

sudo apk add greetd-phrog

# Configure greetd to run phrog:
cat <<HERE | sudo tee -a /etc/conf.d/greetd
cfgfile="/etc/phrog/greetd-config.toml"
HERE

rc-update add greetd

Fedora

# Phrog is not yet available in Fedora's repos
sudo dnf copr enable samcday/phrog
sudo dnf install phrog

sudo systemctl enable phrog

Other

Want to use phrog on another distro? Please get in touch.

If you want to run it manually, you'll need to build from source (see below), and then take a look at the existing packaging to understand how to wire up the necessary bits to spawn a functional greeter session under greetd.

Development

libphosh is required to build this project.

  • Alpine (v3.21+): sudo apk add libphosh
  • Fedora: sudo dnf install libphosh-devel
  • Debian: sudo apt install libphosh-0.44-dev

If libphosh is not packaged for your distro, you need to build Phosh+libphosh manually. See the Phosh README for more info.

Once libphosh is installed, building and running 🐸 should be as simple as:

# To run phrog without greetd, pass --fake
# You can "login" to any user with the password "0" 
phoc -S -E "cargo run -- --fake"

phoc -S -E "cargo test"

Getting help

Found a bug or want to request a feature? Please file an issue!

You can also come chat in Matrix: #phosh:talk.puri.sm