Skip to content
This repository has been archived by the owner on Feb 25, 2021. It is now read-only.
/ mate-i3-applet Public archive

i3 workspace applet for MATE (unsupported, see top of README)

License

Notifications You must be signed in to change notification settings

city41/mate-i3-applet

Repository files navigation

MATE i3 Workspace Applet

No Maintenance Intended

screenshot

This applet shows the current state of i3 workspaces when using i3 as your window manager in MATE.

Unsupported! (as of Aug 15, 2019)

I am sorry but I am not supporting this applet. I built it because it met a need I have. But the truth is I'm not a very good Python programmer, nor do I really know much at all about mate internals or various Linux distros. I don't have the time to learn these things unfortunately.

If anyone is interested in taking over, please let me know by creating an issue here in the repo

Features

  1. shows all workspaces in a similar fashion as i3bar
  2. urgent workspaces highlight same as i3bar
  3. shows modes such as "resize"
  4. clicking a workspace goes to that workspace
  5. uses the same colors as your i3bar in your i3 config (see below)
  6. robust, reconnects if i3 relaunches

Tested On

  • Ubuntu MATE 16.04 with MATE 1.12.1 and i3 4.11 (However no longer supporting GTK 2, see below)
  • Ubuntu MATE 17.10 with MATE 1.18.0 and i3 4.13
  • Ubuntu MATE 18.04 with MATE 1.20.1

There has been one report of the applet not working on Ubuntu MATE 18.10

Other Distros

Debian: It has been reported to work on Debian 10 after installing gir1.2-matepanelapplet-4.0 package. Discussion here

Only supporting GTK3

MATE 1.18.0 made the switch to GTK. This applet checks MATE version and imports appropriate version of GTK, however if you use GTK2 and encounter an issue, please upgrade before creating an issue. GTK2 specific issues will not be addressed.

How to Install

Requires Python 3 (minimum 3.5), no other dependencies

  1. Grab the most recent release
  2. sudo ./setup.py install
  3. killall mate-panel - this should kill then bring mate panel back, and it will now know about the i3 applet
  4. Right click a panel, choose 'Add to panel...' and add the i3 applet

How to setup i3 for this applet

The point of this applet is to use a MATE panel instead of an i3 bar. But, this applet also reads your bar config to determine the colors to use. This is not a catch-22, as i3 allows you to define invisible bars. So in your i3 config, define one bar like so:

bar {
    tray_output None
    mode invisible
    colors {
        background #000000
        statusline #ffffff
        separator #666666

        focused_workspace  #4c7899 #285577 #ffffff
        active_workspace   #333333 #5f676a #ffffff
        inactive_workspace #333333 #222222 #888888
        urgent_workspace   #2f343a #900000 #ffffff
        binding_mode       #2f343a #900000 #ffffff
    }
}

tray_output None: tells the bar to not accept tray icons. This allows them to go to the MATE panel.

mode invisible: means the bar is invisible and never shown. We really only want the bar for its colors...

colors: define the colors you want here. The applet will use these colors. Check the i3 user guide for more info on how to specify colors.

If you just want default colors

If you don't define a bar, or your bar doesn't have any colors defined, then the applet will use i3's default colors. Incidentally, the bar example above is what the default colors are.

Todo

Check the github issues, tracking all known issues and work there

License

This applet is using the BSD license. I also copied i3-ipc's source over into this applet because I needed the latest version and its not yet published to PyPI. i3-ipc is also licensed under the BSD license.