- Use the Source, Luke
Home | Register | News | Forums | Guide | MyLinks | Bookmark

Sponsored Links

Latest News
  General News
  Press Releases
  Off Topic

Back to files

-- README for HackedBox 0.8.x --

This is the README for HackedBox 0.8.x release.

The source tree for HackedBox is comprised of five subdirectories:

        data/           - this holds the default data files that HackedBox
                          requires for proper operation

        doc/            - this holds the documentation files that explain
                          the various aspects of HackedBox

        nls/            - this holds the message files used to generate
                          message catalogs for different languages

        src/            - this holds the actual C++ source code for the window

        util/           - this holds source code for small utility programs
                          that help HackedBox do what it does best.

        epist/          - contains the source code for epistrophy, a keygrabber
        bbkeys/         - contains the source code for bbkeys, another
                          keygrabber appliction.

Quick Start:

The quickest and easiest way to get HackedBox up and running is to run the following commands:

# cd HackedBox-0.7.x
# ./configure
# make
# su -c 'make install'

This will configure, compile and install HackedBox the quickest. For those who like to spend the extra 15 seconds reading ./configure --help, some compile time options can be turned on and off before the build.

For general information on GNU's ./configure, see the file INSTALL.

Configuring HackedBox:

The next thing most users want to do after installing HackedBox is to configure the colors, fonts, menus, etc. to their liking. This is covered by the files data/README, data/ and data/ These files give detailed information on how to customize your new window manager.

Included utilities:

Currently, the only included utilities are a program named bsetroot and a script called bsetbg. bsetroot is a replacement for xsetroot, minus a few options. The difference between xsetroot and bsetroot is that bsetroot has been coded for multiple screens (e.g. multi-headed displays), where as the stock xsetroot is not. The bsetbg script acts as a wrapper for most of the popular programs used to set background pixmaps, making it possible for styles to provide a machine-independent rootCommand.

Third-party utilities:

Supported Platforms:

Linux 2.4.x PPC (glibc2.1)
Linux i686
WinNT (XFree cygwin)
FreeBSD 4.6-STABLE i686
OpenBSD 3.2 (i386)

Please email for other success reports.

Sponsored Links

Discussion Groups
  Networking / Security

About | FAQ | Privacy | Awards | Contact
Comments to the webmaster are welcome.
Copyright 2006 All rights reserved.