quodlibetLCDScreen/README.md

59 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2024-11-04 23:57:59 +00:00
# quodlibetLCDScreen
2020-10-19 14:38:30 +00:00
2020-10-19 15:05:14 +00:00
This is a little plugin for Quod Libet audio player that allow you to display current song Artist/Title on an external USB LCD Screen.
2020-10-19 15:19:09 +00:00
![screen1](lcd.jpg)
2024-11-04 23:57:59 +00:00
## Hardware compatibility
2020-10-19 15:05:14 +00:00
2024-11-04 23:57:59 +00:00
I used this screen : <https://www.banggood.com/1602-RGB-LCD-Display-With-USB-Port-For-Raspberry-Pi-3B-2B-B-Windows-Linux-p-1079617.html>
2020-10-19 15:05:14 +00:00
2024-11-04 23:57:59 +00:00
## Dependencies
2020-10-19 15:05:14 +00:00
2024-11-04 23:57:59 +00:00
- lcd2usb : <https://github.com/xyb/lcd2usb>
2020-10-19 15:05:14 +00:00
- quodlibet libs
- getpass
- GTK libs
2024-11-04 23:57:59 +00:00
## Udev rules
2020-10-19 15:05:14 +00:00
2020-10-19 18:37:44 +00:00
- On Ubuntu, add this rule in `/etc/udev/rules.d/51-lcd2usb.rules`
2020-10-19 15:05:14 +00:00
2024-11-04 23:57:59 +00:00
```shell
2020-10-19 15:05:14 +00:00
# Find your device information with command "lsusb"
# Change ATTR{idVendor} and ATTR{idProduct} to match.
#
# In my case : Bus 006 Device 002: ID 0403:c630 Future Technology Devices International, Ltd lcd2usb interface
#
# This allows users to access the usb device without requiring root permissions
#
SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ATTR{idVendor}=="0403", ATTR{idProduct}=="c630", MODE="0666"
```
- Then reboot computer or refresh udev : `sudo udevadm control --reload-rules`
2020-10-19 14:38:30 +00:00
2024-11-04 23:57:59 +00:00
## Manual install
2020-10-19 18:37:44 +00:00
2024-11-04 23:57:59 +00:00
On Ubuntu
2020-10-19 18:37:44 +00:00
- Create a directory named `quodlibetLCDScreen` in `~/.quodlibet/plugins`
- Copy `quodlibetLCDScreen.py` in this directory
- Open Quodlibet and activate the plugin, you should see a `Hello <your_username>` on the screen
2024-11-04 23:57:59 +00:00
## Screenshots
2020-10-19 15:19:09 +00:00
![screen1](screen_1.jpeg)
![screen1](screen_2.jpeg)
2024-11-04 23:57:59 +00:00
## Credits
2020-10-19 14:38:30 +00:00
This script has been written by Francois B. (Makotosan)
2024-11-04 23:57:59 +00:00
- Email : <francois@makotonoblog.be>
- Website : <https://makotonoblog.be/applications/quodlibetlcdscreen/>
2020-10-19 14:38:30 +00:00
2024-11-04 23:57:59 +00:00
## Licence
2020-10-19 14:38:30 +00:00
2024-11-04 23:57:59 +00:00
- The script/plugin is licensed under the terms of the GPLv3