GithubHelp home page GithubHelp logo

varuneranki / btnx-config Goto Github PK

View Code? Open in Web Editor NEW

This project forked from cdobrich/btnx-config

0.0 0.0 0.0 1.3 MB

btnx-config is a configuration tool for btnx (Button Extension). It allows the user to send keyboard combinations or execute commands with mouse buttons. btnx-config provides mouse and button detection, and an easy way to configure btnx's behavior. See https://github.com/cdobrich/btnx/ for btnx.

License: GNU General Public License v2.0

Shell 8.94% C 64.61% C++ 4.99% Makefile 6.94% M4 13.67% Yacc 0.79% sed 0.04% Objective-C 0.02%

btnx-config's Introduction

btnx-config

btnx-config is the configuration graphical user-interface (GUI) tool for btnx (Button Extension). It allows the user to send keyboard combinations or execute commands with mouse buttons. btnx-config provides mouse and button detection, and an easy way to configure the software's behavior. See https://github.com/cdobrich/btnx/ for information on the backend btnx.

Main window

Button detection window

Button configuration window

Warning

To avoid possibly problems, Configuration Names should contain no space (and probably no special symbols). The use of underscores is fine. This used to not be a problem, but recently I've noticed (in Fedora 21) btnx-config barfs if you try to feed it a file that has spaces in the name. Will look into fixing this in the long term.

History

btnx and btnx-config was originally written by Olli Salonen. However he has ceased development of the code and one of the repositories is lost. Afraid the code might be totally lost if it is not hosted somewhere, I acquired his blessing to move the project here and maintain it. (Meaning this isn't a fork.) It is now being maintained (albeit limitedly at the moment), particularly for major bugs.

Licences

GNU GPL v2

Programming Languages

C

Building

Dependencies

To build on Ubuntu or Debian, you need the following dependencies:

  • build-essential
  • libdaemon-dev
  • libglade2-dev For Manjaro, install libglade instead.
  • libgtk2.0-dev

On most Ubuntu machines, these are available without needing additional sources being enabled on your apt-package respositories. To install these dependencies, run the following commands on the commandline:

sudo apt install libdaemon-dev libglade2-dev libgtk2.0-dev

To build on Fedora or Redhat, you need the following dependencies:

  • libdaemon-devel
  • libglade2-devel

To build on Manjaro you need the following dependencies:

  • libglade

On Fedora, you may need more if you don't have GNU-Make or the C/C++ compilers (gcc/g++) installed.

To install these dependencies, run the following commands on the commandline:

sudo dnf install libdaemon-devel libglade2-devel

Compiling

btnx and btnx-config follow the simple GNU-Make conventions for easy compiling, after you have the dependencies installed. Run these commands from commandline:

./configure

Then run:

make

Installing

btnx and btnx-config follow the simple GNU-Make conventions for installing, after you have successfully run the compiling step. Run this commands from commandline:

sudo make install

Uninstalling

btnx and btnx-config follow the simple GNU-Make conventions for uninstalling:

sudo make uninstall

Using btnx-config

Assuming you have successfully compiled and installed btnx and btnx-config, you can now configure your mouse-buttons.

Starting btnx-config

Older versions of Ubuntu can use the KDE application menu button to invoke the btnx-config graphical program. It requires the program gksu. However Debian and Ubuntu have both decided to move away from using the gksu, gksudo, kdesu, and kdesudo programs for security concerns. You can try to install gksu program IF it is available for your Linux system. But these programs are being gradually phased out, in favor of using the simple sudo command. Instead you should simply invoke the program from a commandline window using the more common sudo command:

sudo btnx-config

When the older versions of Ubuntu Linux 16.04 LTS is no longer supported by April 2021, the KDE menu button generation will be removed.

Troubleshooting

If receive the following error message when trying to use the KDE application menu button to invoke the btnx-config graphical program:

Could not find the program 'gksu'

This means the helper program 'gksu' is not installed on your system. Debian and Ubuntu have both decided to move away from using the gksu, gksudo, kdesu, and kdesudo programs for security concerns. You can try to install this program IF it is available for your Linux system. But these programs are being gradually phased out, in favor of using the simple sudo command. Instead you should simply invoke the program from a commandline window using the more common sudo command:

sudo btnx-config

btnx-config's People

Contributors

cdobrich avatar doktoil-makresh avatar lingo avatar asl97 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.