Skip to content

Latest commit

 

History

History
401 lines (264 loc) · 13.1 KB

SUPPORT.md

File metadata and controls

401 lines (264 loc) · 13.1 KB

FAQ

Shortcuts

How can I list the predefined shortcuts?

You can reach a quick introduction pressing Super + Shift + ?

How can I (re-)declare shortcuts?

You can add your $bindsym lines to a file in ~/.config/sway/config.d/:

$bindsym $mod+Shift+e exec $shutdown

to remove existing shortcuts (for example to reuse them elsewhere) you can $unbindsym them:

$unbindsym $mod+w

Disabling integrations

We tried to allow opt-outs of most tools by just not having them installed. All tools listed as optdepends in the PKGBUILD can be removed and re-installed at your discretion.

How can I remove an auto-starting application?

Refer to the autostart section of our definitions to find the variables.

Add an entry to .config/sway/definitions.d/autostart.conf for each command you'd like to disable:

set $auto_xdg_keyboard ""

Upgrades

How can I align my setup with the current list of packages for a new iso?

manjaro-sway-align

how do I upgrade the ~/.config after an update?

After upgrading packages, you will sometimes need to update your skeleton: skel

This has the potential to override your customizations (even though we try to not do that). You will find a backup as ~/.config-backup-xxx in case you messed it up!

how do I upgrade the greeter configuration?

sudo curl -s https://raw.githubusercontent.com/Manjaro-Sway/iso-profiles/sway/community/sway/desktop-overlay/etc/greetd/config.toml -o /etc/greetd/config.toml

Why are pacman downloads so slow?

You can add fasttrack mirrors using this command:

sudo pacman-mirrors --geoip && sudo pacman -Syyu

Why are your packages not in the regular Manjaro Repositories?

Submissions to the Manjaro Repositories are partly manual and thus hard to align with our release process. Thus we provide the packages via our own package repository, if the packages in question aren't listed in the manjaro repositories.

Can I switch Manjaro lifecycle branches?

Switching between Manjaro lifecycle branches is easy:

sudo pacman-mirrors --api --set-branch {branch}
sudo manjaro-sway-mirrors
sudo pacman -Syyu

How can I track updates?

Major changes specific to this flavor of manjaro are mostly being done in the desktop-settings repo.

Customizing

How can I customize sway without losing my customizations after an upgrade?

You can add variable overrides in ~/.config/sway/definitions.d/ and add more sway configuration inside ~/.config/sway/config.d/. please refer to the arch wiki and the sway wiki for lots of ideas and hints. Make sure the files in either location end in .conf for them to be loaded.

How can I create my own color theme?

Best you start off with one of the existing themes. Those can be activated using the manjaro-sway-theme utility.

Afterwards the primary files you'll need to edit are:

  • ~/.config/sway/definitiond.d/theme.conf
  • ~/.config/foot/foot.ini

Feel free to contribute your themes and optimizations to our themes directory.

How can I customize waybar without losing my customization after an upgrade?

Copy over and edit the customization template, it will get picked up automatically:

cp ~/.config/waybar/config.jsonc.example ~/.config/waybar/config.jsonc

How can I customize the foot terminal without losing my customization after an upgrade?

Copy over and edit the customization template, it will get picked up automatically:

cp ~/.config/foot/foot.ini.example ~/.config/foot/foot.ini

How can I edit the swayidle settings (sleep/lock etc.)?

Copy over the default idle-config and edit the settings

cp /etc/sway/idle.yaml ~/.config/sway/idle.yaml

How can I add my own and override existing sworkstyle icons?

Copy over and edit the customization template, it will get picked up automatically:

cp ~/.config/sworkstyle/config.toml.example ~/.config/sworkstyle/config.toml

You can find missing icons in the sworkstyle logs, /tmp/sworkstyle.log.

Setup and configuration

How can I adapt the settings of my display?

We're using the way-displays to manage our displays. If the initial settings don't fit your needs, a good starting point would be to use

way-displays -w

to write out your current configuration and adapt the configuration (.config/way-displays/cfg.yaml) going from there.

How can I move the waybar from top to bottom?

Change the waybar position by creating or updating your ~/.config/waybar/config.jsonc:

{
    "include": [
        "/usr/share/sway/templates/waybar/config.jsonc"
    ],
    "position": "bottom"
}

How can I log in inside a virtual machine?

While it seems to work out of the box in some kvm/qemu/libvirt environments, you need to enable 3D acceleration at least in VirtualBox and Gnome Boxes.

How can I add more keyboard layouts to sway?

Copy over our configuration example:

cp ~/.config/sway/config.d/XX-keyboard.conf.example ~/.config/sway/config.d/01-keyboard.conf

refer to man sway-input and the arch wiki for more pointers.

How can I configure another path for the screenshots to be saved?

By default screenshots are being stored in $HOME/Screenshots. If you'd like to change that, just add/change a line XDG_SCREENSHOTS_DIR="$HOME/Screenshots" in ~/.config/user-dirs.dirs.

How can I configure adaptive brightness?

cp -r /etc/xdg/wluma ~/.config/

and configure wluma ~/.config/wluma/config.toml according to your needs.

How can I extend the zsh configuration?

You can add you own zsh configuration to ~/.config/zsh/config.d/.

How can I disable the help onscreen menu permanently?

Disable it using the shortcut, the state should be persisted.

Why do my auto-login settings from the installer have no effect?

greetd, our login messenger, is not supported by the manjaro installer. refer here for help.

How can I get a fixed geo location for the weather module?

Copy over and edit the configuration file, it will get picked up upon reloading the waybar:

cp ~/.config/weather.cfg.example ~/.config/weather.cfg

How can I set a fixed geo location for the night-light feature?

Update the waybar module by creating or updating your ~/.config/waybar/config.jsonc with appropriate values for latitude and longitude:

{
    "include": [
        "/usr/share/sway/templates/waybar/config.jsonc"
    ],
    "custom/sunset": {
        "interval": "once",
        "tooltip": false,
        "return-type": "json",
        "format": "{icon}",
        "format-icons": {
            "on": "",
            "off": ""
        },
        "exec": "latitude=50.1 longitude=8.7 /usr/share/sway/scripts/sunset.sh",
        "on-click": "/usr/share/sway/scripts/sunset.sh toggle; pkill -RTMIN+6 waybar",
        "exec-if": "/usr/share/sway/scripts/sunset.sh check",
        "signal": 6
    },
}

How can I delete the clipboard history?

You can middle click on the icon on waybar or run cliphist wipe command inside your terminal.

How can I purge the clipboard history on logout?

add a definition ~/.config/sway/definitions.d/cliphist.conf:

set $purge_cliphist_logout true

How can I follow the windows as I move them?

add a definition ~/.config/sway/definitions.d/window-follow.conf:

set $focus_after_move true

How can I determine the app_id for a running application?

This lists all ids of the opened applications:

swaymsg -t subscribe -m '[ "window" ]' | jq -r --unbuffered .container.app_id

How can I assign a window to a specific workspace?

assign [class="Emacs"] workspace number 1

How can I enable github notifications?

install and authenticate with the github cli:

pacman -S github-cli
gh auth login

How can I use w/a/s/d for directional navigation?

create a new file ~/.config/sway/definitions.d/02-directional.conf

# unassign the rofi menu from $mod+d
$unbindsym $mod+d
# assign the menu to whatever you like
$bindsym $mod+Shift+d exec $menu

# unassign the window stacking menu from $mod+s
$unbindsym $mod+s
# assign the stacking mode to whatever you like
$bindsym $mod+Shift+s layout stacking

# unassign the window tabbing menu from $mod+s
$unbindsym $mod+w
# assign the tabbing mode to whatever you like
$bindsym $mod+Shift+w layout tabbed

# assign the directional keys
set $left a
set $down s
set $up w
set $right d

How can I change the wallpaper/background image?

Add a config file to definitions e.g. .config/sway/definitions.d/01-background.conf:

set $background /usr/share/backgrounds/whatever/file/you/like.png
set $apply_background swaymsg 'output * bg $background fill'

Can I have a different wallpaper/background per monitor?

Yup! Extending from the above example, we'll pass a different background image to two separate output statements, but this time specify which monitor instead of using output * to send the same background to all.

First, we need to get identifiers for each of your monitors. With all of your monitors are connected, run swaymsg -t get_outputs. You'll see an information block for each monitor, like the following:

Output eDP-1 'BOE 0x095F Unknown' (focused)
  Current mode: 2256x1504 @ 59.999 Hz
  Power: on
  Position: 0,0
  Scale factor: 1.200000
  Scale filter: linear
  Subpixel hinting: unknown
  Transform: normal
  Workspace: 1: ‭‬ ‭‬
  Max render time: off
  Adaptive sync: disabled
  Allow tearing: no
  Available modes:
    2256x1504 @ 59.999 Hz
    2256x1504 @ 47.998 Hz

Output DP-1 'Dell Inc. AW3423DWF 9H3G2S3'
  Current mode: 3440x1440 @ 99.982 Hz
  Power: on
  <snip>

Note that on the first line of each block, there is a short name (i.e. eDP-1) and a long name (i.e. 'Dell Inc. AW3423DWF 9H3G2S3'). You can use either in your configuration. The short name may be reused across different devices. The long name is unique to the model of monitor.

Following our above example, we'll add or modify our config file in .config/sway/definitions.d/01-background.conf:

set $bg0 /usr/share/backgrounds/whatever/file/you/like.png
set $bg1 /usr/share/backgrounds/whatever/other/file/you/like.png
set $apply_background swaymsg 'output "Dell Inc. AW3423DWF 9H3G2S3" bg $bg0 fill; output eDP-1 bg $bg1 fill'

Note that we leverage the functionality of swaymsg to parse multiple output definitions as long as they are separated by a semicolon. Ensure that each identifier is wrapped in double quotation marks if it includes spaces.

How can I take a Screenshot?

Press the Print button on your keyboard and you will be presented with some options on the waybar. Depending on what you would like to take a screenshot of, you have to press a combination of keys. To take a full screenshot of the current screen just press - Shift + o on your keyboard.

I get weird screen distortions (with an intel iGPU)

Try to disable Panel Self Refresh (PSR), a power saving feature used by Intel iGPUs. A temporary solution is to disable this feature using the kernel parameter i915.enable_psr=0.

How do I enable numlock on startup?

Check the identifier for your keyboard:

swaymsg -t get_inputs | jq -r '.[].identifier' | grep -i keyboard

Add the following in your sway config:

input "1:1:AT_Translated_Set_2_keyboard" xkb_numlock enabled

How do I enable ssh-agent on startup?

  1. Enable the gcr-ssh-agent.socket systemd user unit:

    systemctl --user enable gcr-ssh-agent.socket

  2. Set SSH_AUTH_SOCK="$XDG_RUNTIME_DIR/gcr/ssh" in your environment, for example by adding

    export SSH_AUTH_SOCK="$XDG_RUNTIME_DIR/gcr/ssh"

    to a file in $HOME/.config/profile.d

See the Arch Wiki for more information.

Recommended tools

Finding tools that work great on sway/wayland is hard. This aims at helping people to find the tools which "just work"™️.

purpose package description
discord aur/vesktop-bin only discord client that works well with wayland and allows to configure screen-share quality
code aur/visual-studio-code-insiders-bin only the "insiders" version currently plays well on wayland
arcade aur/highscore + libretro- dubbed "gnome games", this just works
vm gnome-boxes just another vm player, but works well with design and all.
system upgrade topgrade just upgrades everything
display arrangement way-displays auto-arranges displays and allows for a vast amount of configurations