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 ).

Work on samurai-x2 has been halted. See  http://www.samurai-x.org/pipermail/samuraix_users/2010-June/000004.html

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  git://samurai-x.org/ooxcb.git)
•  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

To obtain the latest development version of ooxcb:

git clone git://samurai-x.org/ooxcb.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