Looking for contributors

[FFY00]

The state of this project has not been great in the last few years. A bit of history: This repo used to be owned by @pwr. A few years he got inactive, locking up administration privileges. Because of this it was impossible to add new maintainers and ultimately everything fell into the shoulders of @Lekensteyn. This was obviously not great as it is too much work for a single person to handle, especially as an hobby project! Needless to say this took a toll on the project, accumulating a lot of open issues.

Thankfully, around 4 months ago we were able to reach @pwr and move the repo to the https://github.com/pwr-Solaar organization! After this I stepped up as a maintainer, in hope to lift @Lekensteyn of many of his burdens. This was a step in the right direction but unfortunately both me and @Lekensteyn are still not enough to properly maintain this project. Because of this we are looking for new people to help out with that.

If anyone is wiling to become a maintainer you can start by triaging the issues on the bugtracker. Help people debugging issues, try to solve simple issues and send PRs. You can mention me in the issues if you have any technical questions, mainly regarding the protocol, and/or need some hardware tested, since I have a bunch of devices (see https://github.com/libratbag/libratbag/wiki/Devices).

Thank you everyone!

[rathann]

Thanks for stepping up. As an owner of a couple of Unifying devices, I recently took over maintenance of solaar package in Fedora and updated it to the latest release. It's still not ideal, but far better than what it was a year ago. I can offer some limited help with quality bug reports and triaging as part of my package maintenance work and spread the word that the project needs help.

[FFY00]

Thank you! I think what we really need is manpower. Helping out with triaging would be awesome! I can assist on the technical matters of the protocol but I really don't have time to go through the issues. Maybe I'll have some time around Christmas because I sort of get a break from college.

[alvgalrus]

I could lend a hand sometimes, most of the questions are just "I installed 0.9.2 and I'm missing options" anyway... I also have access to three different Logitech wireless mice (G305, MX Anywhere, MX Master).

[FFY00]

Other thing new contributors could do: #582

Figure out which features are available on your device and not yet implemented and try to add support.

[FFY00]

Other thing people can help with: #591

Refactor the documentation.

[pfps]

I've added closure comments to a few bug reports.
I'm also trying to get receiver c534 to pair better.
Better documentation on current HID++ protocols would help a lot.

[FFY00]

Thank you!

Better documentation on current HID++ protocols would help a lot.

I will get on that.

[drupal-daffie]

Better support for MX Master 3.

[pfps]

As python2.7 is officially deprecated I suggest dropping support for it in solaar. A bit in the documentation saying so and maybe something added to the installation script is probably needed if so.

[FFY00]

Since @pfps stepped up, this is no longer an issue. It would still be great to get more people contributing though. I propose closing this, @pfps what do you think?

[pfps]

@FFY00 It would be nice to have testers that would test out changes. A couple of people are willing, but more would be useful.

[FFY00]

Alright, I've renamed the issue.

[sk8geek]

Hi, thanks for the continued work on this project. I have MX Keys (and an M350 Pebble mouse), happy to help with testing against that. Would like to help with code but I'm a Java dev so not familiar with Python. I want to understand an issue with my keyboard backlight coming on every few seconds so have spent some time in Wireshark looking through USB packets. I don't think it's Solaar related. Cheers.

[barolo]

Hi, thanks for the continued work on this project. I have MX Keys (and an M350 Pebble mouse), happy to help with testing against that. Would like to help with code but I'm a Java dev so not familiar with Python. I want to understand an issue with my keyboard backlight coming on every few seconds so have spent some time in Wireshark looking through USB packets. I don't think it's Solaar related. Cheers.

@sk8geek you should move your issues to a separate thread, we've been working on MX Keys which is pretty much identical to Craft [ minus its crown ]

[pfps]

If you are already watching all conversations for this repository you should be receiving messages about new pull requests. Checking these messages and testing those PRs that are relevant would be very useful. I'll try to add a comment about what hardware is needed to test the PR. Many PRs can be at least partially tested with any hardware.

[pfps]

I added a new label to be used in pull requests - Ready for testing. I'm also adding in comments on what is needed to test the pull request. Hopefully you have seen a couple of comments - feel free to test out these pull requests. The easiest way to test a pull request is to fetch it into your clone of Solaar via:

git fetch origin pull/XXX/head:pull_XXX
git checkout pull_XXX

where XXX is the number of the pull request.
Then you can run the pull request via bin/solaar.

[mschilli87]

@pfps: I think it would be good to include additional tags for affected devices (or device categories). For example, I wouldn't mind testing the occasional PR that modifies something w.r.t. my Logitech mouse, but having to read all PRs just to find that they affect keyboards only (which I do not own a Solaar-compatible model) would feel like a waste of my time.

In general, I think this repository would benefit from all devices, all keyboards, all mice, model foo, model bar, etc. tags on issues and PRs as many users are likely affected by only a smaller part of the codebase.

[pfps]

I'll see what I can do. I have been trying to add comments on who should test PRs so you only have to look at the messages about PRs to see what you can test.