You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
input-remapper/keymapper/gui/window.py

882 lines
29 KiB
Python

#!/usr/bin/python3
# -*- coding: utf-8 -*-
# key-mapper - GUI for device specific keyboard mappings
# Copyright (C) 2021 sezanzeb <proxima@sezanzeb.de>
#
# This file is part of key-mapper.
#
# key-mapper is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# key-mapper is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with key-mapper. If not, see <https://www.gnu.org/licenses/>.
"""User Interface."""
import math
import os
import sys
from gi.repository import Gtk, Gdk, GLib
from keymapper.data import get_data_path
from keymapper.paths import get_config_path
from keymapper.state import custom_mapping, system_mapping
from keymapper.presets import find_newest_preset, get_presets, \
delete_preset, rename_preset, get_available_preset_name
from keymapper.logger import logger, COMMIT_HASH, VERSION, EVDEV_VERSION, \
is_debug
from keymapper.groups import groups, GAMEPAD, KEYBOARD, UNKNOWN, \
GRAPHICS_TABLET, TOUCHPAD, MOUSE
from keymapper.gui.row import Row, to_string
from keymapper.key import Key
from keymapper.gui.reader import reader
from keymapper.gui.helper import is_helper_running
from keymapper.injection.injector import RUNNING, FAILED, NO_GRAB
from keymapper.daemon import Daemon
from keymapper.config import config
from keymapper.injection.macros import is_this_a_macro, parse
def gtk_iteration():
"""Iterate while events are pending."""
while Gtk.events_pending():
Gtk.main_iteration()
CTX_SAVE = 0
CTX_APPLY = 1
CTX_ERROR = 3
CTX_WARNING = 4
CTX_MAPPING = 5
CONTINUE = True
GO_BACK = False
ICON_NAMES = {
GAMEPAD: 'input-gaming',
MOUSE: 'input-mouse',
KEYBOARD: 'input-keyboard',
GRAPHICS_TABLET: 'input-tablet',
TOUCHPAD: 'input-touchpad',
UNKNOWN: None,
}
# sort types that most devices would fall in easily to the right.
ICON_PRIORITIES = [
GRAPHICS_TABLET, TOUCHPAD, GAMEPAD, MOUSE, KEYBOARD, UNKNOWN
]
def with_group(func):
"""Decorate a function to only execute if a device is selected."""
# this should only happen if no device was found at all
def wrapped(window, *args):
if window.group is None:
return True # work with timeout_add
return func(window, *args)
return wrapped
def with_preset_name(func):
"""Decorate a function to only execute if a preset is selected."""
# this should only happen if no device was found at all
def wrapped(window, *args):
if window.preset_name is None or window.group is None:
return True # work with timeout_add
return func(window, *args)
return wrapped
class HandlerDisabled:
"""Safely modify a widget without causing handlers to be called.
Use in a with statement.
"""
def __init__(self, widget, handler):
self.widget = widget
self.handler = handler
def __enter__(self):
self.widget.handler_block_by_func(self.handler)
def __exit__(self, *_):
self.widget.handler_unblock_by_func(self.handler)
def on_close_about(about, _):
"""Hide the about dialog without destroying it."""
about.hide()
return True
class Window:
"""User Interface."""
def __init__(self):
self.dbus = None
self.start_processes()
self.group = None
self.preset_name = None
css_provider = Gtk.CssProvider()
with open(get_data_path('style.css'), 'r') as file:
css_provider.load_from_data(bytes(file.read(), encoding='UTF-8'))
Gtk.StyleContext.add_provider_for_screen(
Gdk.Screen.get_default(),
css_provider,
Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION
)
gladefile = get_data_path('key-mapper.glade')
builder = Gtk.Builder()
builder.add_from_file(gladefile)
builder.connect_signals(self)
self.builder = builder
# set up the device selection
# https://python-gtk-3-tutorial.readthedocs.io/en/latest/treeview.html#the-view
combobox = self.get('device_selection')
self.device_store = Gtk.ListStore(str, str, str)
combobox.set_model(self.device_store)
renderer_icon = Gtk.CellRendererPixbuf()
renderer_text = Gtk.CellRendererText()
renderer_text.set_padding(5, 0)
combobox.pack_start(renderer_icon, False)
combobox.pack_start(renderer_text, False)
combobox.add_attribute(renderer_icon, 'icon-name', 1)
combobox.add_attribute(renderer_text, 'text', 2)
combobox.set_id_column(0)
self.confirm_delete = builder.get_object('confirm-delete')
self.about = builder.get_object('about-dialog')
self.about.connect('delete-event', on_close_about)
# set_position needs to be done once initially, otherwise the
# dialog is not centered when it is opened for the first time
self.about.set_position(Gtk.WindowPosition.CENTER_ON_PARENT)
self.get('version-label').set_text(
f'key-mapper {VERSION} {COMMIT_HASH[:7]}'
f'\npython-evdev {EVDEV_VERSION}' if EVDEV_VERSION else ''
)
window = self.get('window')
window.show()
# hide everything until stuff is populated
self.get('vertical-wrapper').set_opacity(0)
self.window = window
# if any of the next steps take a bit to complete, have the window
# already visible (without content) to make it look more responsive.
gtk_iteration()
# this is not set to invisible in glade to give the ui a default
# height that doesn't jump when a gamepad is selected
self.get('gamepad_separator').hide()
self.get('gamepad_config').hide()
self.populate_devices()
self.timeouts = []
self.setup_timeouts()
# now show the proper finished content of the window
self.get('vertical-wrapper').set_opacity(1)
self.ctrl = False
self.unreleased_warn = False
self.button_left_warn = False
if not is_helper_running():
self.show_status(CTX_ERROR, 'The helper did not start')
def setup_timeouts(self):
"""Setup all GLib timeouts."""
self.timeouts = [
GLib.timeout_add(100, self.check_add_row),
GLib.timeout_add(1000 / 30, self.consume_newest_keycode)
]
def start_processes(self):
"""Start helper and daemon via pkexec to run in the background."""
# this function is overwritten in tests
self.dbus = Daemon.connect()
debug = ' -d' if is_debug() else ''
cmd = f'pkexec key-mapper-control --command helper {debug}'
logger.debug('Running `%s`', cmd)
exit_code = os.system(cmd)
if exit_code != 0:
logger.error('Failed to pkexec the helper, code %d', exit_code)
sys.exit()
def show_confirm_delete(self):
"""Blocks until the user decided about an action."""
text = f'Are you sure to delete preset "{self.preset_name}"?'
self.get('confirm-delete-label').set_text(text)
self.confirm_delete.show()
response = self.confirm_delete.run()
self.confirm_delete.hide()
return response
def key_press(self, _, event):
"""To execute shortcuts.
This has nothing to do with the keycode reader.
"""
_, focused = self.get_focused_row()
if isinstance(focused, Gtk.ToggleButton):
return
gdk_keycode = event.get_keyval()[1]
if gdk_keycode in [Gdk.KEY_Control_L, Gdk.KEY_Control_R]:
self.ctrl = True
if self.ctrl:
# shortcuts
if gdk_keycode == Gdk.KEY_q:
self.on_close()
if gdk_keycode == Gdk.KEY_r:
reader.refresh_groups()
if gdk_keycode == Gdk.KEY_Delete:
self.on_restore_defaults_clicked()
def key_release(self, _, event):
"""To execute shortcuts.
This has nothing to do with the keycode reader.
"""
gdk_keycode = event.get_keyval()[1]
if gdk_keycode in [Gdk.KEY_Control_L, Gdk.KEY_Control_R]:
self.ctrl = False
def initialize_gamepad_config(self):
"""Set slider and dropdown values when a gamepad is selected."""
if GAMEPAD in self.group.types:
self.get('gamepad_separator').show()
self.get('gamepad_config').show()
else:
self.get('gamepad_separator').hide()
self.get('gamepad_config').hide()
return
left_purpose = self.get('left_joystick_purpose')
right_purpose = self.get('right_joystick_purpose')
speed = self.get('joystick_mouse_speed')
with HandlerDisabled(left_purpose, self.on_left_joystick_changed):
value = custom_mapping.get('gamepad.joystick.left_purpose')
left_purpose.set_active_id(value)
with HandlerDisabled(right_purpose, self.on_right_joystick_changed):
value = custom_mapping.get('gamepad.joystick.right_purpose')
right_purpose.set_active_id(value)
with HandlerDisabled(speed, self.on_joystick_mouse_speed_changed):
value = custom_mapping.get('gamepad.joystick.pointer_speed')
range_value = math.log(value, 2)
speed.set_value(range_value)
def get(self, name):
"""Get a widget from the window"""
return self.builder.get_object(name)
def on_close(self, *_):
"""Safely close the application."""
logger.debug('Closing window')
self.save_preset()
self.window.hide()
for timeout in self.timeouts:
GLib.source_remove(timeout)
self.timeouts = []
reader.terminate()
Gtk.main_quit()
def check_add_row(self):
"""Ensure that one empty row is available at all times."""
rows = self.get('key_list').get_children()
# verify that all mappings are displayed.
# One of them is possibly the empty row
num_rows = len(rows)
num_maps = len(custom_mapping)
if num_rows < num_maps or num_rows > num_maps + 1:
logger.error(
'custom_mapping contains %d rows, '
'but %d are displayed',
len(custom_mapping), num_rows
)
logger.spam(
'Mapping %s',
list(custom_mapping)
)
logger.spam(
'Rows %s',
[(row.get_key(), row.get_symbol()) for row in rows]
)
# iterating over that 10 times per second is a bit wasteful,
# but the old approach which involved just counting the number of
# mappings and rows didn't seem very robust.
for row in rows:
if row.get_key() is None or row.get_symbol() is None:
# unfinished row found
break
else:
self.add_empty()
return True
def select_newest_preset(self):
"""Find and select the newest preset (and its device)."""
device, preset = find_newest_preset()
group = groups.find(name=device)
if device is not None:
self.get('device_selection').set_active_id(group.key)
if preset is not None:
self.get('preset_selection').set_active_id(preset)
def populate_devices(self):
"""Make the devices selectable."""
device_selection = self.get('device_selection')
with HandlerDisabled(device_selection, self.on_select_device):
self.device_store.clear()
for group in groups.filter(include_keymapper=False):
types = group.types
if len(types) > 0:
device_type = sorted(types, key=ICON_PRIORITIES.index)[0]
icon_name = ICON_NAMES[device_type]
else:
icon_name = None
self.device_store.append([group.key, icon_name, group.key])
self.select_newest_preset()
@with_group
def populate_presets(self):
"""Show the available presets for the selected device.
This will destroy unsaved changes in the custom_mapping.
"""
presets = get_presets(self.group.name)
if len(presets) == 0:
new_preset = get_available_preset_name(self.group.name)
custom_mapping.empty()
path = self.group.get_preset_path(new_preset)
custom_mapping.save(path)
presets = [new_preset]
else:
logger.debug(
'"%s" presets: "%s"',
self.group.name, '", "'.join(presets)
)
preset_selection = self.get('preset_selection')
with HandlerDisabled(preset_selection, self.on_select_preset):
# otherwise the handler is called with None for each preset
preset_selection.remove_all()
for preset in presets:
preset_selection.append(preset, preset)
# and select the newest one (on the top). triggers on_select_preset
preset_selection.set_active(0)
def clear_mapping_table(self):
"""Remove all rows from the mappings table."""
key_list = self.get('key_list')
key_list.forall(key_list.remove)
custom_mapping.empty()
def can_modify_mapping(self, *_):
"""Show a message if changing the mapping is not possible."""
if self.dbus.get_state(self.group.key) != RUNNING:
return
# because the device is in grab mode by the daemon and
# therefore the original keycode inaccessible
logger.info('Cannot change keycodes while injecting')
self.show_status(
CTX_ERROR,
'Use "Restore Defaults" to stop before editing'
)
def get_focused_row(self):
"""Get the Row and its child that is currently in focus."""
focused = self.window.get_focus()
if focused is None:
return None, None
box = focused.get_parent()
if box is None:
return None, None
row = box.get_parent()
if not isinstance(row, Row):
return None, None
return row, focused
def consume_newest_keycode(self):
"""To capture events from keyboards, mice and gamepads."""
# the "event" event of Gtk.Window wouldn't trigger on gamepad
# events, so it became a GLib timeout to periodically check kernel
# events.
# letting go of one of the keys of a combination won't just make
# it return the leftover key, it will continue to return None because
# they have already been read.
key = reader.read()
if reader.are_new_devices_available():
self.populate_devices()
# TODO highlight if a row for that key exists or something
# inform the currently selected row about the new keycode
row, focused = self.get_focused_row()
if key is not None:
if isinstance(focused, Gtk.ToggleButton):
row.set_new_key(key)
if key.is_problematic() and isinstance(focused, Gtk.ToggleButton):
self.show_status(
CTX_WARNING,
'ctrl, alt and shift may not combine properly',
'Your system might reinterpret combinations ' +
'with those after they are injected, and by doing so ' +
'break them.'
)
if row is not None:
row.refresh_state()
return True
@with_group
def on_restore_defaults_clicked(self, *_):
"""Stop injecting the mapping."""
self.dbus.stop_injecting(self.group.key)
self.show_status(CTX_APPLY, 'Applied the system default')
GLib.timeout_add(100, self.show_device_mapping_status)
def show_status(self, context_id, message, tooltip=None):
"""Show a status message and set its tooltip.
If message is None, it will remove the newest message of the
given context_id.
"""
status_bar = self.get('status_bar')
if message is None:
status_bar.remove_all(context_id)
if context_id in (CTX_ERROR, CTX_MAPPING):
self.get('error_status_icon').hide()
if context_id == CTX_WARNING:
self.get('warning_status_icon').hide()
status_bar.set_tooltip_text('')
else:
if tooltip is None:
tooltip = message
self.get('error_status_icon').hide()
self.get('warning_status_icon').hide()
if context_id in (CTX_ERROR, CTX_MAPPING):
self.get('error_status_icon').show()
if context_id == CTX_WARNING:
self.get('warning_status_icon').show()
if len(message) > 55:
message = message[:52] + '...'
status_bar.push(context_id, message)
status_bar.set_tooltip_text(tooltip)
def check_macro_syntax(self):
"""Check if the programmed macros are allright."""
self.show_status(CTX_MAPPING, None)
for key, output in custom_mapping:
if not is_this_a_macro(output):
continue
error = parse(output, custom_mapping, return_errors=True)
if error is None:
continue
position = to_string(key)
msg = f'Syntax error at {position}, hover for info'
self.show_status(CTX_MAPPING, msg, error)
def on_rename_button_clicked(self, _):
"""Rename the preset based on the contents of the name input."""
new_name = self.get('preset_name_input').get_text()
if new_name in ['', self.preset_name]:
return
self.save_preset()
new_name = rename_preset(
self.group.name,
self.preset_name,
new_name
)
# if the old preset was being autoloaded, change the
# name there as well
is_autoloaded = config.is_autoloaded(
self.group.key,
self.preset_name
)
if is_autoloaded:
config.set_autoload_preset(self.group.key, new_name)
self.get('preset_name_input').set_text('')
self.populate_presets()
@with_preset_name
def on_delete_preset_clicked(self, _):
"""Delete a preset from the file system."""
accept = Gtk.ResponseType.ACCEPT
if len(custom_mapping) > 0 and self.show_confirm_delete() != accept:
return
custom_mapping.changed = False
delete_preset(self.group.name, self.preset_name)
self.populate_presets()
@with_preset_name
def on_apply_preset_clicked(self, _):
"""Apply a preset without saving changes."""
self.save_preset()
if custom_mapping.num_saved_keys == 0:
logger.error('Cannot apply empty preset file')
# also helpful for first time use
if custom_mapping.changed:
self.show_status(
CTX_ERROR,
'You need to save your changes first',
'No mappings are stored in the preset .json file yet'
)
else:
self.show_status(
CTX_ERROR,
'You need to add keys and save first'
)
return
preset = self.preset_name
logger.info(
'Applying preset "%s" for "%s"',
preset, self.group.key
)
if not self.button_left_warn:
if custom_mapping.dangerously_mapped_btn_left():
self.show_status(
CTX_ERROR,
'This would disable your click button',
'Map a button to BTN_LEFT to avoid this.\n'
'To overwrite this warning, press apply again.'
)
self.button_left_warn = True
return
if not self.unreleased_warn:
unreleased = reader.get_unreleased_keys()
if unreleased is not None and unreleased != Key.btn_left():
# it's super annoying if that happens and may break the user
# input in such a way to prevent disabling the mapping
logger.error(
'Tried to apply a preset while keys were held down: %s',
unreleased
)
self.show_status(
CTX_ERROR,
'Please release your pressed keys first',
'X11 will think they are held down forever otherwise.\n'
'To overwrite this warning, press apply again.'
)
self.unreleased_warn = True
return
self.unreleased_warn = False
self.button_left_warn = False
self.dbus.set_config_dir(get_config_path())
self.dbus.start_injecting(self.group.key, preset)
self.show_status(
CTX_APPLY,
'Starting injection...'
)
GLib.timeout_add(100, self.show_injection_result)
def on_autoload_switch(self, _, active):
"""Load the preset automatically next time the user logs in."""
key = self.group.key
preset = self.preset_name
config.set_autoload_preset(key, preset if active else None)
config.save_config()
# tell the service to refresh its config
self.dbus.set_config_dir(get_config_path())
def on_select_device(self, dropdown):
"""List all presets, create one if none exist yet."""
self.save_preset()
if self.group and dropdown.get_active_id() == self.group.key:
return
# selecting a device will also automatically select a different
# preset. Prevent another unsaved-changes dialog to pop up
custom_mapping.changed = False
group_key = dropdown.get_active_id()
if group_key is None:
return
logger.debug('Selecting device "%s"', group_key)
self.group = groups.find(key=group_key)
self.preset_name = None
self.populate_presets()
reader.start_reading(groups.find(key=group_key))
self.show_device_mapping_status()
def show_injection_result(self):
"""Show if the injection was successfully started."""
state = self.dbus.get_state(self.group.key)
if state == RUNNING:
msg = f'Applied preset "{self.preset_name}"'
if custom_mapping.get_symbol(Key.btn_left()):
msg += ', CTRL + DEL to stop'
self.show_status(CTX_APPLY, msg)
self.show_device_mapping_status()
return False
if state == FAILED:
self.show_status(
CTX_ERROR,
f'Failed to apply preset "{self.preset_name}"'
)
return False
if state == NO_GRAB:
self.show_status(
CTX_ERROR,
'The device was not grabbed',
'Either another application is already grabbing it or '
'your preset doesn\'t contain anything that is sent by the '
'device.'
)
return False
# keep the timeout running
return True
def show_device_mapping_status(self):
"""Figure out if this device is currently under keymappers control."""
group_key = self.group.key
state = self.dbus.get_state(group_key)
if state == RUNNING:
logger.info('Group "%s" is currently mapped', group_key)
self.get('apply_system_layout').set_opacity(1)
else:
self.get('apply_system_layout').set_opacity(0.4)
@with_preset_name
def on_copy_preset_clicked(self, _):
"""Copy the current preset and select it."""
self.create_preset(True)
@with_group
def on_create_preset_clicked(self, _):
"""Create a new preset and select it."""
self.create_preset()
def create_preset(self, copy=False):
"""Create a new preset and select it."""
self.save_preset()
name = self.group.name
preset = self.preset_name
try:
if copy:
new_preset = get_available_preset_name(name, preset, copy)
else:
new_preset = get_available_preset_name(name)
custom_mapping.empty()
path = self.group.get_preset_path(new_preset)
custom_mapping.save(path)
self.get('preset_selection').append(new_preset, new_preset)
self.get('preset_selection').set_active_id(new_preset)
except PermissionError as error:
error = str(error)
self.show_status(CTX_ERROR, 'Permission denied!', error)
logger.error(error)
def on_select_preset(self, dropdown):
"""Show the mappings of the preset."""
# beware in tests that this function won't be called at all if the
# active_id stays the same
self.save_preset()
if dropdown.get_active_id() == self.preset_name:
return
self.clear_mapping_table()
preset = dropdown.get_active_text()
if preset is None:
return
logger.debug('Selecting preset "%s"', preset)
self.preset_name = preset
custom_mapping.load(self.group.get_preset_path(preset))
key_list = self.get('key_list')
for key, output in custom_mapping:
single_key_mapping = Row(
window=self,
delete_callback=self.on_row_removed,
key=key,
symbol=output
)
key_list.insert(single_key_mapping, -1)
autoload_switch = self.get('preset_autoload_switch')
with HandlerDisabled(autoload_switch, self.on_autoload_switch):
autoload_switch.set_active(config.is_autoloaded(
self.group.key,
self.preset_name
))
self.get('preset_name_input').set_text('')
self.add_empty()
self.initialize_gamepad_config()
custom_mapping.changed = False
def on_left_joystick_changed(self, dropdown):
"""Set the purpose of the left joystick."""
purpose = dropdown.get_active_id()
custom_mapping.set('gamepad.joystick.left_purpose', purpose)
self.save_preset()
def on_right_joystick_changed(self, dropdown):
"""Set the purpose of the right joystick."""
purpose = dropdown.get_active_id()
custom_mapping.set('gamepad.joystick.right_purpose', purpose)
self.save_preset()
def on_joystick_mouse_speed_changed(self, gtk_range):
"""Set how fast the joystick moves the mouse."""
speed = 2 ** gtk_range.get_value()
custom_mapping.set('gamepad.joystick.pointer_speed', speed)
def add_empty(self):
"""Add one empty row for a single mapped key."""
empty = Row(window=self, delete_callback=self.on_row_removed)
key_list = self.get('key_list')
key_list.insert(empty, -1)
def on_row_removed(self, single_key_mapping):
"""Stuff to do when a row was removed
Parameters
----------
single_key_mapping : Row
"""
key_list = self.get('key_list')
# https://stackoverflow.com/a/30329591/4417769
key_list.remove(single_key_mapping)
def save_preset(self, *_):
"""Write changes to presets to disk."""
if not custom_mapping.changed:
return
try:
path = self.group.get_preset_path(self.preset_name)
custom_mapping.save(path)
custom_mapping.changed = False
# after saving the config, its modification date will be the
# newest, so populate_presets will automatically select the
# right one again.
self.populate_presets()
except PermissionError as error:
error = str(error)
self.show_status(CTX_ERROR, 'Permission denied!', error)
logger.error(error)
for _, symbol in custom_mapping:
if is_this_a_macro(symbol):
continue
if system_mapping.get(symbol) is None:
self.show_status(CTX_MAPPING, f'Unknown mapping "{symbol}"')
break
else:
# no broken mappings found
self.show_status(CTX_MAPPING, None)
# checking macros is probably a bit more expensive, do that if
# the regular mappings are allright
self.check_macro_syntax()
def on_about_clicked(self, _):
"""Show the about/help dialog."""
self.about.show()
def on_about_key_press(self, _, event):
"""Hide the about/help dialog."""
gdk_keycode = event.get_keyval()[1]
if gdk_keycode == Gdk.KEY_Escape:
self.about.hide()