What is ctrlproxy?

CtrlProxy runs on a computer with a 24/7 internet connection and allows you to transparently connect to IRC from anywhere on the world to your nick. It connects to one or more IRC servers and then allows you to connect to it with any number of clients, providing access to these servers. This is very useful if you don't want to leave IRC but still want to be able to use it from home, school or work.

News

  • 14 Jun, 2008. Released 3.0.7 (GPG signature)
  • 13 Apr, 2008. Released 3.0.6 (GPG signature)
  • 7 Dec, 2007. Released 3.0.5 (GPG signature)
  • 24 Nov, 2007. Released 3.0.4 (GPG signature)
  • 22 Jul, 2007. Released 3.0.3
  • 15 Apr, 2007. Released 3.0.2
  • 4 Jan, 2007. Released 3.0.1
  • 8 Dec, 2006. Released 3.0.0
  • 5 Dec, 2006. Released 3.0beta1
  • 30 Jul, 2006. Released 3.0alpha1
  • 8 May, 2006. _charly_ has submitted a patch to add a -bzr suffix to all binaries for those running stable and unstable copies on the same box.
  • 24 Apr, 2006. Bugs are now in the bugtracking system at bugs.bitlbee.org.
  • 18 Apr, 2006. Development is not dead. We've been busy working on 3.0. Alphas are coming up.
  • 16 Mar, 2005. Released 2.7-test3
  • 14 Mar, 2005. Released 2.6.2
  • 9 Jan, 2005. Released 2.7-test2
  • 11 May, 2004. CtrlProxy is discussed in two hacks in the O'Reilly title "IRC Hacks" by Paul Mutton.

Other news is often posted on Jelmer's blog.

Features

There is a comparison of ctrlproxy with other IRC proxies/bouncers.

  • Connect to one server with many clients under one nick transparently
  • Connect to multiple servers using only one process
  • CTCP support when no client is attached
  • irssi-style logging support
  • Transparent detaching and attaching of clients
  • Password support
  • Auto-Away support
  • Backlog replication. Replicate from last client quit or last line said by user.
  • Keeping track of number of times a certain user uses a certain pattern
  • Direct, inetd-style interfacing with local IRC servers (such as bitlbee)
  • Responses to queries are only sent to the originating client of the query
  • SSL support
  • Flood protection
  • Logging in a user-specified format
  • IPv6 support

A list of features that will be included in future releases can be found in the roadmap.

Requirements

  • GNU glib
  • GNU TLS (optional)

Building

ctrlproxy can be installed from source by running: 


$ ./configure
$ make
$ make install

If you have a Bazaar checkout, run : 


$ ./autogen.sh

before you run ./configure, make and make install

Download

ctrlproxy 3.0.7 (tar.gz) (GPG signature)

ctrlproxy 3.0.6 (tar.gz) (GPG signature)

Fedora packages at rpmfind.net.

Ctrlproxy in Debian Unstable

Gentoo has a ctrlproxy ebuild.

FreeBSD contains a ctrlproxy port.

Korbinian Rosenegger maintains a repository with Debianized BZR builds.

For OpenSuSE builds, see this page.

The CtrlProxy documentation is also available online.

FAQ

Does it support DCC?

Yes.

Supported Operating Systems

Ctrlproxy has been successfully built and run on the following operating systems:

  • Debian GNU/Linux
  • Gentoo Linux
  • SourceMage Linux
  • Fedora Core / RedHat Linux
  • SuSE Linux
  • FreeBSD
  • OpenBSD
  • CygWin

If you've run it on different platforms, please let me know.

IRC

The ctrlproxy IRC channel is #ctrlproxy at Freenode.

Bzr access

CtrlProxy uses the Bazaar version control system.

The latest and greatest versions of ctrlproxy can always be found in the branches at http://people.samba.org/bzr/jelmer/ctrlproxy.

You can access any of the branches by running:

bzr get http://people.samba.org/bzr/jelmer/ctrlproxy/BRANCH

Where BRANCH is the name of the branch. You'll most likely want trunk.

Bug and wishlist

Please report bugs in the bugtracking system.

Authors

See the file AUTHORS included with the source distribution for a list of contributors.

Recent commits

There is a list of recent commits at cia.vc.