Skip to content

Instantly share code, notes, and snippets.

Last active May 27, 2021 04:26
What would you like to do?
Renaming i3 workspaces with while keeping the <number>: <letter> prefix for keyboard navigation.
#!/usr/bin/env python
# -*- coding: utf-8 -*-
# - Renaming i3 workspaces with while keeping the <number>: <letter> prefix for keyboard navigation.
# Written in 2017 by Fahrstuhl
# To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.
# You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see <>.
import i3ipc
import re
class WorkspaceRenamer(object):
prefixRegex = re.compile('\d+:\S+')
def __init__(self):
self.i3 = i3ipc.Connection()
def findFocusedWorkspace(self):
focused = self.i3.get_tree().find_focused()
workspace = focused.workspace()
return workspace
def getWorkspacePrefix(self):
workspace = self.findFocusedWorkspace()
oldname =
prefix = self.prefixRegex.match(oldname)
if prefix is None:
raise LookupError("No workspace name found")
return prefix[0]
def interactiveRenameCurrentWorkspace(self):
prefix = self.getWorkspacePrefix()
renameCommand = 'rename workspace to "{} %s"'.format(prefix)
inputCommand = """exec i3-input -F '{}' -P "Rename workspace to: {} " """.format(renameCommand, prefix)
def main():
renamer = WorkspaceRenamer()
if __name__ == "__main__":
Copy link

ekeih commented Aug 18, 2017


thank you for this helpful script!
I would like to put it in a repository to adjust it for my use case. Could you please add some licensing information?

Thank you in advance!

Copy link

Oops, I overlooked your comment, sorry.
It's CC0 now.

Copy link

ekeih commented Dec 31, 2017

Awesome, thank you 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment