You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Eric Jiang efccef3334 Fix wrong command in help 9 months ago
.github Add issue template instructions 8 years ago
.gitignore Add .gitignore so the compiled binary isn't committed 3 years ago
50-usb-scale.rules Add another Mettler Toledo ID (found on a PS3L) (#26) 2 years ago
COPYING Added License 13 years ago
Makefile Remove lsusb 1 year ago Update email address 1 year ago
scales.h Compute NSCALES automatically 1 year ago
usbscale.c Fix wrong command in help 9 months ago


Usbscale is a program that reads weight data from a USB scale. Compilation is very simple and should work on any system with libusb-1.0 and gcc.



You will need the development headers for libusb-1.0. Once you have that, you simply need to run make in the source directory. If you get a "permission denied" error when running usbscale, you may need to configure udev on your system to give permission to use the scale. The file 50-usb-scale.rules contains a sample udev rule file that should be placed in /etc/udev/rules.d/.


Simply run usbscale and it will automatically report on the first USB scale that it finds. The weight will be output to stdout, while any diagnostic or error messages will be sent to stderr. An exit code of 0 means that a scale was found and a weight was successfully read. Any other error code indicates that a weight reading was unavailable.

Zeroing the scale

There is somewhat-experimental support for sending a tare command to the scale. You can invoke it by running usbscale zero. Not all scales seem to do the right thing when they receive this command, but please let us know whether your scale works in the GitHub issues.

Adding support for more scales

By default, usbscale only supports a very limited number of USB scales. It does not search for just any USB scale, but only those listed in scales.h. To add support for another USB scale, it should be enough to add its vendor and product IDs to scales.h. In any case, you should contact me (see below) so that I can add your new scale to the main source code to benefit all users who may have the same scale.


The license for usbscale is the GPLv3, whose full text can be found in the file COPYING. This means that you can reproduce and redistribute this software, as long as you provide any and all modifications that you have made to the software available under the same license. Notably, you may not integrate this software into another product without making the whole product open source. This paragraph is not definitive; please read the license carefully.

Additional licensing terms may be negotiable.


If you have a code-related issue (bugs, patches, etc.), then you can create an issue on the usbscale Github repo. Otherwise, the best way to contact me is by sending mail to erjiang at alumni-iu-edu.