Keebie icon indicating copy to clipboard operation
Keebie copied to clipboard

Video Tutorial needed, or any type of tutorial.

Open CristianEnache opened this issue 3 years ago • 6 comments

First of all I must say this piece of software is exactly what I and many others need to enhance our productivity and speed. I saw your (now outdated) video tutorial an it looks great but I can't get the current version to do anything. I can only imagine how many people go through the same steps as me and then give up. That's why I'm leaving this comment here: please do a video tutorial that includes installation, configuration and a few examples of layers.

CristianEnache avatar Nov 08 '21 23:11 CristianEnache

Firstly I think now is a fairly good time to make a tutorial: given that development slowed massively a while back (I think that's on me mostly, I got kinda burnt out on Keebie, programming, and life in general) any tutorial made now would have an alright chance at remaining relevant.

I do somewhat question the need for one though; this is probably a result of me being very aware of how the program works (though I never actually figured out how to use the systemd service, I just run manually) but it does seem quite simple to install and set up. An outside perspective would be quite important here I think.

By the way here are a few simple tests for why Keebie might not be working.

  • Run with --verbose and read the output, it should tell you of any obvious issues.
  • Check if you have set up any devices, this may be done by looking for JSON files in ~/.config/keebie/device/. If none are present a new device may be configured by running keebie --new.
  • Check that device files are are pointing to the correct keyboards, look for the line "event": "<event file name>", and run cat /dev/input/<event file name>, if this outputs unreadable nonsense when typing on the intended keyboard then the event file is correct.
  • Check if there are any commands in the layer file being used, this may be done by looking at the contents of files in ~/.config/keebie/layers/, specifically the layer you are using.
  • Check the permissions on the event file being read, they should be 666 (rw-rw-rw-) and other values may indicate issue with the udev rule.

Michael-E-B avatar Nov 08 '21 23:11 Michael-E-B

Hi Michael,

The 666 permission fixed it for me. The event file had a different permission. I changed it to 666 and it's now working as expected. The --verbose option helps a lot too!

Thank you for your help and take it easy. I hope you'll get over the burnout period soon. Take care!

CristianEnache avatar Nov 12 '21 12:11 CristianEnache

I'm always happy to help.

I would like to know how the permissions came to be incorrect (with the device staying correct I assume). If you would kindly run cat /etc/udev/rules.d/*keebie* and post the output it may be interesting.

Michael-E-B avatar Nov 12 '21 19:11 Michael-E-B

I think it would be really cool for someone ( either me or anyone who is up to it ) to make a updated video going over all the new features @Michael-E-B has added, as they have added a TON of functionality over the past year or so, as well as showing how to set it up. Could be really cool, and would also help in doing a once over in whatever shortcomings we may have in doing a clean install that could be made better

daisyUniverse avatar Nov 17 '21 06:11 daisyUniverse

I nominate not me; I'm a bit camera(/microphone) shy, plus don't have any good one(s).

I have done a few clean install tests and the process is quite smooth for me, but that's a best case scenario.

Michael-E-B avatar Nov 17 '21 06:11 Michael-E-B

I would actually love to do this myself but lately I've found that I have much much less time than I would like for personal projects, so I can't promise anything in any timely manor, though I really DO like the idea of it, so I think this is me saying on paper that I will start working on it. I'll make it it's own issue so that I can update y'all on the progress of that project

daisyUniverse avatar Nov 17 '21 06:11 daisyUniverse