b(aeck's implementation of i) 3 (wm for Windows)

1. Head over to the Release page and download the latest binary zip file.
2. Decompress it somwhere
3. Copy the example.config to bin (See FAQ if you want to personalize the configuration))
4. Execute b3.exe

1. Head over to the Release page and download the latest source zip file.
2. Decompress it somwhere
3. See Compiling
4. Copy the example.config to bin (See FAQ if you want to personalize the configuration))
5. Execute b3.exe

See here.

• Your default Windows expierence stays the same. b3 lives within the Microsoft default Explorer shell and just adds functionalities you know and love of i3.
• Stuff like Alt + Tab is still avialable
• Switching between windows in the plain Windows way will be automatically recognized by b3 (e.g. switch to workspace of that window).
• The Windows 10 desktop are still available but useless when b3 is running.
• It is possible to rebind almost any key combination. Win + h, j, k, l is supported (for l see here)

1. Be as i3 like as possible while integrating into default Windows as easily as possible.
2. Being stable is more important than having more features

A default config file is included in the release zip. To get started right away, it is already placed as config in the same directory as b3.exe.

For more information on where the configuration file can be placed please see the included man page.

Yes, please see here.

• In the unzipped release you can perform man -l man/b3.1 to see the available command line options and where the configuration file can be placed.
• Since b3 tries to be a drop in replacement for i3 you can use i3 User's Guide also for b3. But please cross check it with the compatibility list.
• b3 releases ship a default configuration file. You can check it to see a list of most used commands.

• Currently you have to read the source code entirely to get into b3 development. But most methods/functions have a documentation string. In the future some sort of generated documentation and/or class diagram will be added.

• MinGW
• Collections-C
• w32bindkeys

You will need a functioning MinGW environment. This sections describes the compilation using Msys2.

First install the dependencies:

pacman -S make cmake automake autoconf mingw-w64-x86_64-gcc libtool bison flex mingw64/mingw-w64-x86_64-pcre

Then compile and install Collections-C:

wget https://github.com/srdja/Collections-C/archive/master.zip
unzip master.zip
cd Collections-C-master/
sed -i s/add_subdirectory\(test\)//g CMakeLists.txt # Testing is not needed
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..

Then compile and install w32bindkeys. Please have a look at its README.

Then compile b3:

./autogen.sh
make

Afterwards you may install b3 - depending on your MinGW environment - by performing:

make install

If you are unsatisfied with b3 you may uninstall it again:

make uninstall

First install MinGW:

sudo dnf install -y mingw64-gcc mingw64-gcc-c++ cmake automake autoconf autoconf-archive libtool bison flex mingw64-pcre

Then compile and install Collections-C:

wget https://github.com/srdja/Collections-C/archive/master.zip
unzip master.zip
cd Collections-C-master/
sed -i s/add_subdirectory\(test\)//g CMakeLists.txt # Testing is not needed
mkdir build
cd build
mingw64-cmake ..
sudo make install
sudo cp /usr/x86_64-w64-mingw32/sys-root/mingw/lib/pkgconfig/collectionc.pc /usr/lib64/pkgconfig

Then compile and install w32bindkeys. Please have a look at its README.

Then compile b3:

export PKG_CONFIG_PATH=/usr/x86_64-w64-mingw32/lib/pkgconfig/
./configure --host=x86_64-w64-mingw32
make

The version scheme of w32bindkeys is as follows: x.y.z

• x is the stage:
  • < 0 is an unstable release
  • > 0 is a stable release
• y incidates changes to the API or the configuration file functionalities.
• z indicates additions without breaking any compatibility.

Richard Bäck [email protected]

MIT License

Show me that you really like it by donating something. Thanks for any amount!

My Bitcoin address: 3DF2eTL9KSndqbuQTokWvTbUpDNQ6RuwxU