Welcome to samurai-x

samurai-x is a highly modular and configurable, next generation framework window manager for X. It is written in pure python utilising ctypes ( some people debate if the project is really pure python when using ctypes - all our code is python so we consider it pure python! )

samurai-x is targeted at people wishing to experiment with desktop programming and people who want more control over their desktop ( without having to code in C ).

About

samurai-x was originally written using X-lib ( we call that version samurai-x1 ) but work on this version has been stopped ( though it still lives on in our git repository ) to make way for the newer version ( we call samurai-x2 ) which uses xcb.

samurai-x is written entirely in python using ctypes, depending on the following libraries and modules:

• ooxcb (from the git repository)
• libxcb
• setuptools

Current Features

• a very small core
• plugin system ( almost all functionality is provided by plugins )
• virtual desktops
• focus stack
• window maximisation/moving/resizing
• window decorations
• binding of keys to actions
• user configuration
• many other plugins for various things - plugin docs
• probably more... you'll have to check it out! - Ideas

Screenshots

For more screenshots check out the samurai-x blogs at http://planet.samurai-x.org

Latest development version with yahiko decorator running fbpanel as a taskbar:

samurai-x2 0.1

Downloading and Installing

For instructions on getting started with samurai-x look at http://docs.samurai-x.org/samurai-x2/getting-started.html. For more information about installing under different distributions look at Installation.

To install the latest stable release and all available plugins with easy_install issue the following command:

easy_install samurai-x2 sx-allplugins

To download official releases look in downloads.

To obtain the latest development version issue the following command:

git clone git://samurai-x.org/samuraix.git

Documentation

Our work in progress documentation is located at http://docs.samurai-x.org/samurai-x2.
Documentation for ooxcb can be found at http://docs.samurai-x.org/ooxcb

Contact Us

If you use IRC why not join #samuraix on irc.freenode.net
If you prefer a mailing list, subscribe here: http://www.samurai-x.org/mailman/listinfo/samuraix_users (archives can be found here: http://www.samurai-x.org/pipermail/samuraix_users/)

Developers blogs

You can find our planet at http://planet.samurai-x.org
Also you can follow us on twitter at http://twitter.com/samuraixwm