README.rst

fluidspaces

Usage

This application has two parts; the fluidspaces daemon and the fluidspaces-msg binary used to send messages to the daemon. My setup is to run the daemon as a systemd user service and bind the various messages to keys. I use sxhkd for keybinds, but you can do this just as easily in the i3 config file.

These are the flags expected by fluidspaces-msg:

USAGE:
    fluidspaces-msg [OPTIONS]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -a, --action <action>    Action to perform [default: go_to]  [values: go_to, send_to, bring_to, toggle]

And these are some examples of valid invocations of fluidspaces-msg:

# pick a workspace to go to
fluidspaces-msg --action go_to

# pick a workspace to send the currently active container to
fluidspaces-msg --action send_to

# pick a workspace to go to and bring the currently active container with you
fluidspaces-msg -a bring_to

# go to the most recent non-active workspace
fluidspaces-msg -a toggle

Installation

Arch

Make a folder to build the package in, then enter it (you can delete this folder after installation is complete, so it doesn't matter where it is or what you call it):

mkdir ~/fluidspaces
cd ~/fluidspaces

Download the PKGBUILD script into your folder:

wget https://raw.githubusercontent.com/mosbasik/fluidspaces-rs/dev/PKGBUILD

Build and install the package:

makepkg --syncdeps --install

Add the following lines to your ~/.xinitrc:

# make DISPLAY available to systemd user services
systemctl --user import-environment DISPLAY

# start fluidspaces daemon when i3 starts
systemctl --user start fluidspaces.service

Log out of your X session and log back in. The fluidspaces daemon should be running. Test to see if it is working by opening a terminal and running:

fluidspaces-msg --action go_to

This should open dmenu. Type a word and hit enter - you should be sent to a workspace with that name.

From Source

Todo