super-productivity/docs/wiki/4.-Reference.md
Corey Newton f9a328022d
docs(wiki): initial revision (v0.1)
Contains both a first-draft of content as well as
a comprehensive GH Action to replicate from
docs/wiki to the `.wiki` sub-repo. The linting is
non-blocking at the moment.

- the existing markdown linking appears reliably
rendered in GH but more testing needed.
- style guide for contributions/expectations needs
to be added to the wiki
- **a significant re-work of the README** to
re-direct users to the Wiki is needed to avoid
doc duplication
- updates to the PR templates and contributor
guidelines to emphasize the importance of adding
documentation is still needed
2026-01-20 03:04:08 -08:00

1.9 KiB
Executable file

Settings and Preferences

Keyboard-Shortcuts

  • Shift+P: Open create project dialog
  • Shift+A: Open add task bar
  • Enter: Edit currently focussed task title
  • Arrow keys: Navigate around task list
  • D: Mark currently focused task as done
  • A: Add subtask to currently focused task
  • Y: Toggle tracking time to currently focused task
  • S: Open schedule dialog for currently focused task
  • Backspace: Delete currently focused task
  • ArrowRight: Open additional info panel for currently focused task
  • Ctrl+Shift+ArrowUp: Move currently focused task up in list
  • Ctrl+Shift+ArrowDown: Move currently focused task down in list

Short-Syntax

Can be used when adding a task. (Each of these can be disabled in settings->short syntax)

  • # <tag-name>: add a tag to the task
    ("task-description #tag1")
  • <number>m or <number>h: set time-estimate for the task
    ("task-description 10m" or "task-description 5h")
  • @<time>: add due time to the task ("task-description @fri 10pm")
  • + <project-name>: add the task to an existing project
    ("task-description +Important Project")
  • Ctr + 2: toggle between moving the new task to the bottom and top of the list

JSON-Models

Wayland-Compatibility

If you're experiencing issues running Super Productivity on Wayland (such as rendering problems, VSync errors, or GLib-GObject warnings), you can force the application to use X11 mode by starting it with the --force-x11 parameter:

superproductivity --force-x11

This will automatically apply compatibility fixes including:

  • Forcing the Ozone platform to use X11 instead of Wayland
  • Disabling GPU VSync to prevent GetVSyncParametersIfAvailable() errors
  • Setting the appropriate environment variables for X11 compatibility

The application will automatically detect Wayland sessions and apply these fixes, but you can use this flag if automatic detection doesn't work properly.