Alyrp

Alyrp 🎤 is a .LRC (and text files formatted as .LRC files) viewer for Arduino UNO and Arduino Leonardo. It requires a SD/MicroSD card and a LCD screen. The source code design follows a PlatformIO project.

📡 Hardware

• 1x Microcontroller:

  • Arduino Leonardo
  • Arduino UNO

• 1x SD/MicroSD Card Adapter

  • CATALEX Micro SD Card Module

• 1x LCD Display (I2C module is optional)

  • LCD 16x2
  • LCD 20x4 (recommended)

🔌 Wiring

See src/wiring files. Note that Fritzing is required in order to open .fzz files.

⬇️ Download and code uploading

1. git clone this repo.
2. Install PlatformIO IDE extension in VS Code.
3. Open VS Code.
4. PIO Home > Projects > Add Existing > Select downloaded folder in step 1.
5. Open /include/alyrp.h file and edit the configuration at your needs. (see related comments)
6. Switch PlatformIO project environment (last icon in VSCode status bar)
7. Build.
8. Connect your Arduino to a USB port.
9. Upload.

❓ Other info

1. SD card file hierarchy

   |-- lyrics (mandatory)
   |   |-- song1.lrc
   |   |-- ...
   |-- (other optional directories/files)
   

2. What is a .LRC file?

   https://en.wikipedia.org/wiki/LRC_(file_format) Note that right now, the code ignores all the ID tags, including the [offset:+/-<OFFSET>] one.

3. How to download .LRC files of my favourite songs?

   .LRC file may be included with the song. It usually has the same name of the song itself. You can also take a look at https://github.com/fashni/MxLRC