Skip to content
Projects

amiantos/lurker has 112 GitHub stars and 20 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 15:57 UTC. Last push 2026-11-15.

How these counts are measured

What you can do

  • Always-on and multi-user. Each invited user connects to their own set of IRC networks, and Lurker stays connected when they're away. Admins can restrict which networks users can connect to, and make channel recommendations for newcomers.
  • Modern conveniences. Peer presence, automatic nick regain, join/part summarization, smart nickname completion, cross-client message drafts, bookmarks, user notes, a powerful highlight & ignore system, reactions, replies, and more.
  • Full search. Search your message history, filter by nick, channel, or network; and jump to any message instantly, no matter how old it is.
  • Image uploads. Paste an image into the input box, and Lurker optimizes it, anonymizes it, and uploads it to local storage, S3, Zipline, Chibisafe, or external services like x0.at or catbox.moe.

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Lurker is a delightful self-hosted IRC bouncer and client with a retro aesthetic and modern conveniences.

Self-hosted

README.md

Original

  Lurker

CI Docker image codecov OpenSSF Scorecard License: MPL 2.0 IRC: #lurker

Lurker is a delightful self-hosted IRC bouncer and client with a retro aesthetic and modern conveniences.

Features

  • Always-on and multi-user. Each invited user connects to their own set of IRC networks, and Lurker stays connected when they're away. Admins can restrict which networks users can connect to, and make channel recommendations for newcomers.
  • Modern conveniences. Peer presence, automatic nick regain, join/part summarization, smart nickname completion, cross-client message drafts, bookmarks, user notes, a powerful highlight & ignore system, reactions, replies, and more.
  • Full search. Search your message history, filter by nick, channel, or network; and jump to any message instantly, no matter how old it is.
  • Image uploads. Paste an image into the input box, and Lurker optimizes it, anonymizes it, and uploads it to local storage, S3, Zipline, Chibisafe, or external services like x0.at or catbox.moe.
  • Customizable UI. The beautiful retro terminal-style PWA interface has 40+ settings to customize it how you want.
  • Native apps. Lurker has official native apps for iOS and for Android. A self-hosted server can send native push notifications to both through push.lurker.chat, an optional paid relay. There are also third-party clients such as Spooky (Android), and luir (TUI), which bring their own flavor to Lurker.
  • Built-in bouncer. Don't want to use the Lurker clients? Then don't. Lurker has a best-in-class IRC bouncer built in, complete with soju.im/bouncer-networks, soju.im/FILEHOST support and more, so you can use any IRC client you want, like clircs, Halloy, Goguma, HexDroid and many others.
  • Full DCC & Secure DCC support. DCC SEND and DCC CHAT from anywhere you want, either insecurely or over TLS with SDCC. Fill the XDCC queue with packs, and come back later to all your completed downloads. Admins are in control of which users get access to which DCC features, and set storage limits for those with access to file sharing.
  • Inline link & media previews. Links, images, and videos get proper preview images in every client. Implemented as a separate container, to isolate malicious links from your users' data. (Optional, requires lurker-previews container.)
  • Decoupled IRC connections. Say goodbye to disconnect/reconnect floods when updating Lurker — a secondary container keeps the connections alive while the main service restarts. (Optional, requires lurker-engine container.)

Screenshot (Desktop PWA)

Lurker IRC client screenshot

Screenshots (iOS)

Lurker IRC client screenshots on iOS

Screenshots (Android)

Lurker IRC client screenshots on Android

Rave Reviews

  • <cfuser> amiantos: holy shit, you made something better than irccloud
  • <amigojapan> great, now that amiantos's chat client is catching up to IRC cloud, I think I can switch to it as my daily driver
  • <skdoo> amiantos makes cool shit
  • <jadeia> lurker is really nice. this is streets ahead of irccloud in terms of design and ease of use.
  • <helsinski> Lurker iOS is certainly shaping up to be real good.
  • <quark> These days I am only using Lurker. Desktop and mobile.
  • <CrashOverripe> Lurker solves most of my IRC problems - very happy you decided to take it on as more than just a solution for yourself.
  • <Samien> Ever since I started using Lurker, things have become so much more convenient. I can use IRC anytime, anywhere—whether at the office, at home, or on the metro—without any restrictions. and it's far way better than irc cloud
  • <slakker> welp, Lurker officially won me over as bouncer of choice. dude, you know how fucking handy it is to have what is effectively the most convenient bouncer config tool ever? :D
  • <indigo> Weekly appreciation post for Lurker. Nothing else that runs on my VPS brings me as much joy

Installation

Quick Start

Docker is the officially supported way to run Lurker[^1]. Get started by downloading the example docker-compose.yml file.

curl -O https://raw.githubusercontent.com/amiantos/lurker/main/docker-compose.yml
docker compose up -d

Then open http://localhost:8015 and create your admin account.

[^1]: You can run it without Docker, if you must.

Next Steps

View the full self-hosted guide for information on enabling identd, media previews, web and native push notifications, and connection decoupling.

There's also a one-shot DigitalOcean deploy script which comes out of the box with all of this set up for you. If you're a smartypants, that script can teach you everything you need to know to deploy a production-quality Lurker instance.

Lurker.Chat Service

Just want to use Lurker, without hosting it yourself?

It's $5/month for a single user account on an officially managed Lurker instance at Lurker.Chat.

Try it out for free

Just want to try it out? You can sign up for a free account that can only access irc.lurker.chat at app.lurker.chat/signup.

Documentation

Community

License

Mozilla Public License 2.0 — see LICENSE.