Halloy IRC client

Halloy IRC client logo

Halloy is a new cross-platform IRC client written in Rust.

Installation on Ubuntu 23.04 Linux

flatpak install flathub org.squidowl.halloy

See out blog post Flatpak installation on Ubuntu 23.04 if you don’t have Flatpak installed.

Configuration

When starting up Halloy for the first time, the application greets with instructions on how to get starting with the configuration.

Halloy IRC client new configuration

This is a good thing, though there are some ambiguities as the where the config file should be placed.

Since the application is installed from Flatpak, we have to follow the steps as per the image above.

cp ~/.var/app/org.squidowl.halloy/config/halloy/config.template.yaml ~/.var/app/org.squidowl.halloy/config/halloy/config.yaml

Open the the config.yaml and edit line 24 to set your preferred nickname: nickname: Lamers4tw.

That is the only change you have to do to get connected and chatting.

If the nickname is already taken, the application will keep connecting and then disconnecting a multiple times. Look in the log file mentioned below for troubleshooting information.

You can add additional alternative nicknames with alt_nicks: shown below in the example when connecting to the Darkscience IRC network.

Make sure to keep an eye on the log file located at ~/.var/app/org.squidowl.halloy/data/halloy/halloy.log, since it’s there where you will see the error and warnings.

The project is working on adding more more “user friendly” reporting, some open issues:

They’re also working on themeing, the issue is closed and PR #92 is merged.

Flatpak maintainers seems to not like the $XDG_CONFIG_HOME as per Config.yaml file location amiguity #111. Here is to hoping that it is just some miscommunication and that it will be sorted in the future.

Connecting to other IRC servers

The Lamerschool preferred IRC network is Darkscience. Do forgive us for not being very active on IRC as most most of us have lost our ways. But IRC will survive, and we will be back at some point in time. Open standards will prevail.

This is how you configure and connect to Darkscience:

servers:
  Darkscience:
    nickname: bendoin
    alt_nicks: ["bendoin42", "bendoin43"]
    server: irc.darkscience.net
    port: 6697
    use_tls: true

More help is available at Struct irc::client::data::config::Config

As a bonus, here is how you would setup the IRC bouncer ZNC connection, in case you have that:

servers:
  znc_darkscience:
    nickname: bendoin/darkscience
    password: "SUPERduperPahsswerd"
    server: znc.darkscience.net
    port: 6698
    use_tls: true

Darkscience offers a ZNC bouncer service for anyone supporting their hosting on Darkscience Patreon page. You do have to request it though.

Troubleshooting

Tail the log file during the setup:

tail -f ~/.var/app/org.squidowl.halloy/data/halloy/halloy.log

It might also help to comment out the default Liberachat or your existing servers to reduce the logging.


Make sure to always keep your Operating System(s) and all of the software that you are using up to date.

Feedback on our content or did you find a bug somewhere?

Send us an email to feedback at this domain.

kthxbai