Skip to content
Irssi but with a Cocoa interface
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Frameworks These dependencies don't need to be "installed" Mar 13, 2014
Headers Fix up Headers/ for 64/32-bit and add to Xcode project. Jan 26, 2011
Images Moved/removed a pile of cruft Jun 15, 2010
Sounds Initial commit Jul 15, 2008
Source Moving defaults from AppController to Defaults.m Oct 27, 2014
Themes Fix nickname not displayed in nick change notification Feb 27, 2014
irssi @ 77d9d5e
xcodescripts Strip out this crap, not used now. Feb 11, 2011
.gitignore Tweak gitignore a little for new Xcode and all Feb 1, 2014
.gitmodules Use git over https for submodules Feb 25, 2014
COPYING Initial commit Jul 15, 2008
Info.plist Update bundle version Oct 27, 2014
MacIrssi-Template.sparseimage Added MacIrssi sparseimage and updated package.rb Jun 15, 2010
MacIrssi.icns Initial commit Jul 15, 2008 Added DSA update signing Mar 21, 2009
MacIrssi_Prefix.pch Upgrade to irssi-0.8.14 and snow leopard working Aug 29, 2009
README.markdown README updates Feb 24, 2014
version.plist Initial commit Jul 15, 2008



MacIrssi is an IRC client with a native Mac UI. It's based on irssi, an awesome command-line IRC client.


You can download a binary version of MacIrssi here. These are currently updated whenever I get something worthwhile done, or if a bug gets fixed. If you encounter any issues, please let me know over at the issue tracker.

Branching and Development

MacIrssi uses the GitFlow style of branching and code maintainance. This means the branches have specific names and uses:

  • master: The current release branch. Check this out and build if you want the latest version.
  • develop: The current development HEAD, this is meant to be buildable and runnable at all times.
  • feature/*: Feature branches for new work in the develop tree, very unstable and only really to be built if you need the feature. They disappear after being merged into develop.
  • hotfix/*: A hotfix for the master branch.

It's a good bet that you want the develop branch, unless you're specifically looking to build your own release version. Patches to develop will be gladly accepted if useful, tidy and neat.

Checking Out

To check out the MacIrssi code base, do the following

# git clone <clone url>
# git checkout <desired branch>
# git submodule init
# git submodule update


Compiling MacIrssi is a tricky beast. The plain Irssi core that powers MacIrssi requires glib in order to function. This means compiling up a bunch of GNU libraries in order to build the glib dylib, amongst others, needed to run MacIrssi.

To this end, there is a submodule in MacIrssi called MILibs. There is a target in the main project called "Build MILibs", this target does not get run automatically. You need to forcibly invoke this target, from the top level Xcode project, to build the required libraries. After that, you never need to run it again unless the version of MILibs changes.

Keep an eye out, if the Frameworks/MILibs subproject starts showing up in your diffs after you've checked out then you likely need to update the submodule checkout for that branch.

# git submodule update
You can’t perform that action at this time.