Update 2016-01-16

Development of Crunchbang has now stopped. There are a few community spin-offs available, Bunsen Labs and Crunchbang++. Although most of what's been written here should be applicable to these distributions, it hasn't been tested. I'm now using a netinst version of Debian at home with the i3 window manager, and Bunsen Labs on my office laptop. Both are working well.

For the past year and a half, I've been working primarily on Microsoft's stack – C#.NET, ASP.NET Web Forms, HTML, CSS, JavaScript (jQuery primarily). My company recently started taking up projects on open source software such as PHP, WordPress and Android. This gave me an opportunity to shift to Linux again. I've always been fond of Linux. The ability to customize and fine tune your system to just the way you like it gives me a sense of freedom and power.

Last Friday, I installed Crunchbang. It is a Linux distribution derived from Debian. The purpose of this post is to outline the various steps I followed to get Crunchbang ready for use. I can then refer to this post whenever I'm setting up my system again, or helping someone else set up theirs.

Hardware Configuration

I'll start of with my computer specifications first. This might help people with similar hardware configuration to find a solution to their problems.

Name Configuration
Processor Intel i5-4570 CPU @ 3.20GHz
Motherboard Gigabyte H87M-D3H
Video Card MSI HD 7850 Hawk
Monitor(s) Philips 190VW (1440 X 900) Dell S2240L (1920 x 1080)

System Update

Once Crunchbang is installed and you boot up for the first time a handy script starts up that allows you to update your system and installed software. This script can be invoked later on as well by running cb-welcome command on the terminal.

Installing LAMP and Java

Follow the script and install Java and the LAMP stack. It is also possible to install – Git, SVN and drivers for printer.

Installing AMD Proprietary Driver

After the script has finished, it's time to install the graphics driver.

I followed the manual method outlined in this post on the Crunchbang forums. I tried using smxi to do it for me, but I think it was having trouble disabling the default Radeon drivers. Follow the exact steps, and reboot whenever advised.

Setup dual monitors in AMD CCC

Okay, so driver installation is over. It's time to set up dual monitors. By default, after you've installed Crunchbang on a system that has dual monitors and an AMD graphics card, the monitors will duplicate each other. Once you've installed the driver you can change that setting. Fire up the AMD Catalyst Control Center by running amdcccle command on the terminal.

Change the mode to extend the display to two monitors rather than duplicate the display -

Multiple Monitors in AMD CCC

Placing monitors in the correct order (left or right of each other) is as simple as dragging them into place. You can also change the resolution from this screen.

Another problem that people with DELL S2240L and AMD cards will have that the display on the monitor won't re-size to fit the entire screen. The fix for that is  available through CCC -

Dell S2240L Overscan Correction

Note that the CCC makes changes to the xorg.conf file in /etc/X11. If you don't want to make these changes everytime you reinstall Crunchbang, just backup that file.

Installing Logitech Wireless Driver

I have a wireless Logitech keyboard. With the new motherboard the keyboard is not auto detected by Crunchbang. Installing the driver found here and then restarting resolves the issue.

Boot Error : platform-microcode : intel-ucode ... (not found?)

If you are running new Intel hardware, the following error -

platform microcode: firmware: agent aborted loading intel-ucode/06-1a-05 (not found?)

seems to pop up during boot. It's basically harmless, but can be fixed by installing intel-microcode using APT.

Un-install Software

VLC Media Player

Install Software

Following is a list of software I install after installing #!


Torrent client

sudo apt-get install deluge  


Music player

sudo apt-get install clementine  


Use existing #! script, under the Openbox menu, Networking tab.


Video player

sudo apt-get install mplayer  

Then change add the following to the ~/.mplayer/config -

#Volume softvol=1 softvol-max=400

This raises the max volume to 400%.



sudo apt-get install artha  

Google Chrome

Use existing #! script, under the Openbox menu, Networking tab.


Monitor screen color manager

I know the above line, doesn't make it sound very exciting, but you really should give flux a go.

  • Grab the binary from here. That's the xflux daemon (command line, but for X-Windows).
  • Add the following line to Openbox autostart file to start xflux daemon on system startup.
# l – latitude, g - longitude
xflux -l 17.4 -g 78.5  


Development IDE for PHP

Grab the installer from here


C / C++ Editor

Grab the .deb from here


Grab the .deb installation files from here
Run the following commands one after the other -

sudo dpkg -i *.deb  
cd desktop-integration  
sudo dpkg -i *.deb``  

Customize Startup and Openbox Menu

autostart.sh determines the applications to be run at start-up and menu.xml defines the layout of the Openbox menu.

Here is my current autostart.sh file and here is my menu.xml.

Customize Conky and Tint2

Conky is basically a system monitor software for the X Window System. It can be extend via plugins and can be customized to show things such as weather.

Tint2 is a task-bar designed to be simple and lightweight. Here's my tint2 config file.

My Conky configuration can be found here. The result -

Conky Screenshot

That's it. That's all I do once Crunchbang has been installed. It took me about four hours hours, but with this post as a reference, next time I should be able to reduce that time to about an hour.

Crunchbang is wonderful distribution that is minimalist, fast, stable and extremely customizable. It runs very well on old and new hardware. They have a helpful and friendly community. So, if you are looking for a new Linux distribution to try out, do give Crunchbang a test drive.

  1. List of software that can be installed using APT on !#.