#i dont know how to run or compile this program

166 messages · Page 1 of 1 (latest)

fierce hemlock
#

i was recently bought a mouse with 12 side buttons that are supposed to be reprogrammable, however the software the company provides is windows-only. https://redragonshop.com/blogs/product-download/impact-m908
^^ product page

i found this github repo https://github.com/dokutan/mouse_m908?tab=readme-ov-file#installing and the mouse is on the list of fully supported models. i scanned through the README and downloaded a zip as well, neither of which was able to help me figure out what i'm meant to do. it appears i need to compile it myself somehow or something along those lines, but i haven't the knowledge or experience on how to do that. any help would be appreciated

GitHub

Control various Redragon gaming mice from Linux, BSD and Haiku - dokutan/mouse_m908

#

i also have the user manual but it only outlines what the buttons do without configuration and direct the user to the company website in order to configure them

#

i attempted running the official software through wine once already and it kind of seemed to work but not really and it had a ton of horrible bugs and wouldn't detect the mouse. also wine refused to close afterwards, until i restarted my computer

#

OS is Mint Cinnamon

ornate parrot
#

the releases page there only provides source code via two formats.

#

You're going to find out what unholy really is.

#

libusb (On some distributions (e.g. Ubuntu) a dev package is required)

#

do apt search libusb-dev and see if it lists as installed. Otherwise install it first

#

then unzip either tar or zip to a folder using archive manager or via right-click in file manager eg: contents locate in ~/dokutan-source

#

cd into dokutan-source (or whatever you named the folder) in terminal and run the commands it says for LINUX to make install.

#

whereis make to see if make program is installed. if not, install it via apt

fierce hemlock
ornate parrot
#

each will say in bracket if installed

fierce hemlock
ornate parrot
#

right click: extract here

fierce hemlock
#

terminal?

ornate parrot
#

yeah i quoted a CLI text

fierce hemlock
#

sudo apt install libusb-dev in terminal?

#

still getting used to using it regularly

ornate parrot
#

if it's not present, yes

fierce hemlock
#

ran search a second time after installing and it doesn't appear in brackets still

ornate parrot
#

do apt list -i libusb*

fierce hemlock
#

most of them say installed, and it did pop up in brackets this time

ornate parrot
#

anything resulting with the -i switch means installed

fierce hemlock
#

so i have the zip i grabbed from the github repo, and it has already been extracted

#

this is where i initially reached out for help, at this step in the process

#

now what

ornate parrot
#

go into that folder in terminal

#

pwd to confirm working directory you've logged to

fierce hemlock
#

how do i choose a particular folder to open through terminal

#

i'm fairly new to linux still

ornate parrot
#

usually it opens in userhome

#

pwd

fierce hemlock
#

it just says /home/zimber

ornate parrot
#

then ls --group-directories-first

#

u should see the folder that got made

#

unless u extracted it somewhere else/deeper

fierce hemlock
#

it's in a subfolder

#

i can move it to /home if that'd make it quicker

#

or rather, /zimber ig

ornate parrot
#

cd /<whatever path>

fierce hemlock
#

ah ok

ornate parrot
#

working directory shows in prompt

#

ls to see the files (source code junk)

fierce hemlock
#

do i need to be inside the newly extracted folder or one layer up

ornate parrot
#

in the folder

fierce hemlock
#

i must be putting it in wrong somehow

ornate parrot
#

tilde means userhome

#

so do cd Downloads exact

#

then cd mou and immediately press tab before enter

fierce hemlock
fierce hemlock
ornate parrot
#

if u want for fun

fierce hemlock
#

oh i see

ornate parrot
#

make sure u have make, as i said

fierce hemlock
#

yeah, to compile it

#

it says i

#

it's somewhere in /usr

#

usr/bin/make

ornate parrot
#

so then follow the rest of the LINUX instructions. couple lines

fierce hemlock
#

oh from the github page

ornate parrot
#

and save a screenshot of that instructional in case u gotta uninstall

fierce hemlock
ornate parrot
#

no.

#

what is quoted on website is two individual, and sequential commands

fierce hemlock
#

i tried just make first

#

because i assumed it was a two liner

ornate parrot
#

give it time to compile

fierce hemlock
#

oh

ornate parrot
#

idk how long. maybe 20 sec

#

then run an ls

#

it should've made some new installer binary (executables show in some other colour, usually a bright one)

#

then the last command

fierce hemlock
#

it isn't doing make

#

keeps showing that same fatal error

ornate parrot
#

try make ./

#

or make .

fierce hemlock
ornate parrot
#

which is saying work on what's in the current logged directory

#

ensure that missing package is satisfied first

fierce hemlock
#

did i potentially mess up the libusb dependency or something

ornate parrot
#

im not sure where the libusb dev package they initially mention is

fierce hemlock
#

q-q

#

wait that's the wrong screenshot

ornate parrot
#

ensure the missing package is satisfied first, before running make in this directory

fierce hemlock
#

i don't know how to get back to the correct one

ornate parrot
#

do apt search libusb-1* and show full result

fierce hemlock
ornate parrot
#

install the 9th one

#

...1.0-0.dev

fierce hemlock
#

and now i go back and attempt to do Make again, yes?

ornate parrot
#

ur still in pwd

#

so just make

fierce hemlock
#

oh it's actually doing something now, nice

#

at the very least i have learned how to cd into folders in terminal, so that's cool

#

i think it probably made something, should i check for it in file explorer

#

oh my goodness

ornate parrot
#

or ls

fierce hemlock
#

wait why'd it do my full screen

#

much better

ornate parrot
#

seems fine. now do the sudo make install

#

it should read that makefile for its own guidance and install it appropriately into the system. idk if outcome is a graphical app or just a CLI app.

fierce hemlock
#

it just

ornate parrot
#

now see the USAGE section of the website

fierce hemlock
#

ah ok

#

so in order to set my buttons i just open terminal, cd into this folder, and run whatever commands it says in the usage guide? in the future i mean

ornate parrot
#

idk where the examples.ini file is. maybe in the green mouse_u5... folder u see above . but u can poke around

fierce hemlock
#

these look to be examples

ornate parrot
#

now that it is in the system, u can likely do whereis mouse_m908

#

oh i see the examples folder. it's in the source code master

#

ofc, you'd need to provide the full path to such place

fierce hemlock
ornate parrot
#

what's the path?

fierce hemlock
#

/usr/bin/mouse_m908 /usr/share/man/man1/mouse_m908.1

#

i'm hoping there'll at some point be a GUI menu i can use, but if that's not the case it's fine as long as i can somewhat easily change buttons now and then

ornate parrot
#

so the first path there is the program's location now that you have compiled and installed it. (this is in the standard "back pocket" of linux, so you don't have to type any fancy path to launch it, just its name)

#

the man thing is the manual for it

fierce hemlock
#

oh there's a manual, nice

ornate parrot
#

eg. man mouse_m908.1

#

ctrl-c or q to quit

fierce hemlock
#

quit what? terminal?

ornate parrot
#

the manual page for this program

fierce hemlock
#

oh

#

ok

ornate parrot
#

which runs in the terminal when u type man plus the name of the program

fierce hemlock
#

ooh ok

ornate parrot
#

run cd examples

fierce hemlock
#

so i run the manual in the terminal and learn how to use it, then i run the program itself, using the other command?

ornate parrot
#

yeah this program appears to be CLI only

#

so basically follow the USAGE teachings

fierce hemlock
#

a pain but it is what it is

ornate parrot
#

run pwd

#

you should be where all the examples are.

#

then ls

fierce hemlock
#

same file names and everything

ornate parrot
#

newer type: Apply all macros: mouse_m908 -m ⟨config.ini⟩

#

so in this quote, triangular brackets mean they contain a variable, left to the user to put in. do not type those brackets.

fierce hemlock
#

ok

ornate parrot
#

seems like macros are multiple mouse-clicks or keystrokes you can program in and assign to a button. but i dont deal with this stuff

fierce hemlock
#

yeah

#

i was hoping to just set up what i have on my other mouse on the 11th and 12th keys for now, where i can do forward/back

#

like one does with a browser window or file manager

ornate parrot
#

also you may delete the original zip or tar now

#

also remember all CLI in linux/unix is 100% case-sensitive. so type accurately

fierce hemlock
#

that's good to know

#

so i've favorited all of the new files and folders and such so i can find them easily. basically what i need to do now is more reading?

ornate parrot
#

yeo

#

one other thing

fierce hemlock
fierce hemlock
ornate parrot
#

do echo path

#

oops

fierce hemlock
#

path

ornate parrot
#

echo $PATH

#

that should list all places that already in the 'back pocket' of linux

#

same idea in DOS except command is slightly different

fierce hemlock
#

i'm not familar with DOS

ornate parrot