From Waveshare Wiki
Revision as of 06:38, 30 March 2024 by Eng27 (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


*The USB Monitor series supports NVIDIA and AMD discrete graphics cards, as well as Intel and AMD integrated graphics cards, but does not currently support other graphics card models.
*For USB monitors, it is recommended to prioritize the 2.1/2.8-inch versions. The 3.4/4 inch versions are larger and require consideration of actual chassis space.

Hardware Connection

Desktop Secondary Screen: USB Type-C Connection


PC Case Secondary Screen: 4PIN Interface Connection


Software Setting

  • 1. Download Waveshare PC Monitor.
  • 2. Install the player driver "K-Lite_Codec_Pack.exe" in the PCMonitor directory:
① Select "Fresh install"

5inch-USB-Monitor Software-1.png

② All select "Next"

5inch-USB-Monitor Software-2.png

③ Click on "Finish" to end the driver installation

5inch-USB-Monitor Software-3.png

  • 3. Double-click to open PCMonitor software, "Connected" on the top left corner, choose your favorite theme on the right side, and click "Run" to display it.

2.8inch USB Monitor05.png

Theme Customization

1. Enter "Theme Edit" Interface

2.8inch USB Monitor06.png

2. Video Setting

① Click "+ Video", and set up the original (X, Y) and video size.
② Set the correct video path, save the created video file into the "/video/480x480" file directory, and select it. (PS: H264 encoding format file is required).
③ Click "Save", and the corresponding video is previewed. (you can edit it by right-clicking on the layer). For example, if the original coordinates are set as (0,0), and the video size is 480x480, then the theme will present a full-screen effect.
2.8inch USB Monitor07.png

3. Images Setting

① Click "+ Image", and set up the centered coordinates as (X, Y) and the centered position is (240, 240) by default.
② Set the correct image path, save the created image file into the "/image/480x480" file directory, and select it.
③ Click "Save", and the corresponding image is previewed. (you can edit it by right-clicking on the layer).
2.8inch USB Monitor08.png

4. Clock Setting

① Click "+ Clock", and place the images corresponding to "hour," "minute," and "second" in the "/image/480x480" directory and select them.
② Set the relative positions of three-pointer images and rotate them around the central origin.
③ Open system data and set them separately as "hour," "minute," and "second ".
④ Set the maximum values for system data, with "hour" set to 60, and "minute" and "second" set to 60.
2.8inch USB Monitor12.png

5. Text Setting

① Click on "+ Text" to set the text's coordinates ((240,240) is centered by default, and draggable using the mouse).
② Set the text content, FgColor, and font, then click "Save" to apply.
③ After checking "System Data", the corresponding dynamic values of the system data will be displayed.

2.8inch USB Monitor13.png

6. Circular PrgBar Setting

① Click "+ Circular PrgBar " to set up the basic parameters of the circle such as the coordinates, diameter, arc width, and arc spacing.
② Set the color, and it supports three gradient colors (or display one color).
③ Set the starting and ending angles of the arc to control the display direction and arc length.
④ After checking the system data and setting the upper and lower data limits, the corresponding system data will be converted into the dynamic effect of the Circular PrgBar.

2.8inch USB Monitor09.png

7. HOR PrgBar Setting

① Click on "+ HOR PrgBar" to set the basic parameters of the horizontal progress bar, such as its coordinates, width, height, corner radius, and border width.
② Set the border color, the BgColor of the HOR PrgBar, and the FgColor of the content, supporting gradient foreground display. (If not selected, it will display the same color.)
③ After checking "System Data," the corresponding system data will be converted into dynamic effects for the HOR PrgBar.

2.8inch-USB-Monitor 10.png

8. Audio Arc Setting

① Click "+ Audio arc" to set the basic parameters such as the circle coordinates and the diameter.
Sound Column Ring Width: The carrier for all sound columns will be displayed in the outer ring of the audio circle.
Sound Column Width: Indicates the width value of each individual sound column, value = 7 is recommended.
Sound Column Width Interval: Indicates the width interval value of each sound column, value = 2 is recommended.
Sound Column Max Height: Indicates the max height value of each sound column, value = 50 is recommended.
Display Direction: Set the rotation direction of the sound column ring, clockwise or anticlockwise.
Start Position: Set the starting position of the sound column ring, up/down/left/right.
Sound Column Start Color: All column colors are generated by gradient colors, and the starting color represents the gradient starting color of the first independent sound column.
Sound Column End Color: All column colors are generated by gradient colors, and the ending color represents the gradient ending color of the first independent sound column.
Sound Column Ring Color: Indicates the color of the outer sound column ring.
Audio Solid Lines Color: Indicates the middle solid line of the sound column ring.
Audio Dashed Lines Color: Indicates the solid line of the internal sound column ring.
Start Frequency: Set the starting frequency of the microphone or .wav file spectrum; (spectrum range: 1-20000).
End Frequency: Set the ending frequency of the microphone or .wav file spectrum; (spectrum range: 1-20000).
Mic Gain: Sets the degree of amplification for the microphone to acquire the ambient sound input signal and controls the sensitivity to the sound signal; (gain value range: 0-31).
Audio Path: Set the path of .wav audio file, and only take effect when the audio data source is "wav file".
Audio Data Source: Set the data source of the audio signal for the audio circle.

  • "randomNumbers": use the random data frequency.
  • "audio mic": use the mic to get the ambient sound frequency.
  • "wav file": use the frequency band of the .wav audio file.


Windows-USB-Monitor Image Programming

1. Click to download 3.4inch-USB-Monitor-RPi image.
2. Download the compressed file to the PC, and unzip it to get the .img file.
3. Remove the TF card, use the SDFormatter software to format the TF card.
4. Open the Win32DiskImager software, select the system image prepared in Step 1, and click "Write".
5. After programming, insert the TF card into the card slot of the screen.
6. Using a USB cable to connect the Type-C interface of the screen to the USB interface of the PC.
7. Power on the PC, after waiting for a few seconds, you should see the screen light up with the logo pattern, indicating that the image has been successfully burned.




Please check and install the K-Lite.exe driver, then restart your Windows computer and try again.
How to install K-Lite.exe: keep selecting "Next" until it "Finish".


Due to the software compatibility, it does not support macOS currently. Compatibility for future updates can be achieved through firmware upgrades. Please stay tuned for further information.



Supported device: PC and tablet.
Supported systems: Win10 and Win11 (Requires a system version from 2021 or later).
Note: the tablet may be not compatible with the fan or other components, it is recommended to analog use before downloading the software.



For storing the image, the factory TF card burns the image file by default and places it in the TF slot, so customers can use it when they receive it.



Changing the bootlogo.bmp inside the TF card to a customized image will enable you to modify the boot logo.



Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)