What this mode does
Single Track Entry is the in-app upload flow for adding songs to the local library. You can select one song or select multiple files at once, review how the system reads them, and then save only the valid items to the song database.
The current uploader allows up to 500 selected files. When a song uses separate music, lyric, and timing files, select the related files together so the system can group them by base name.
Step 1: Open the song manager
![[Mockup placeholder: Main player with the context menu or bottom-right gear/settings button highlighted, then the “Manage Songs” option highlighted]](/uploads/mockups/add-songs-single-step-1.png)
[Mockup placeholder: Main player with the context menu or bottom-right gear/settings button highlighted, then the “Manage Songs” option highlighted]
Open Manage Songs
- 1
Right-click on the main player screen, or open the settings menu from the gear button at the bottom-right of the screen.
- 2
Select “จัดการเพลง” (Manage Songs).
- 3
In the first tab, choose “เพิ่มเพลง” (Add Songs). This is the single-file/library upload flow, not the bulk compressed import tab.
Step 2: Choose Add Songs
![[Mockup placeholder: Manage Songs modal showing the Add Songs tab and the upload button]](/uploads/mockups/add-songs-single-step-2.png)
[Mockup placeholder: Manage Songs modal showing the Add Songs tab and the upload button]
Step 3: Upload supported files
![[Mockup placeholder: Add Songs tab with the “อัปโหลดไฟล์เพลง” button, file picker, and selected file list]](/uploads/mockups/add-songs-single-step-3.png)
[Mockup placeholder: Add Songs tab with the “อัปโหลดไฟล์เพลง” button, file picker, and selected file list]
Step 4: Review the result
- 1
Wait while the system reads and prepares the selected files.
- 2
Review the file list and the status counters: Total, Valid, Duplicate, and Error.
- 3
Remove an unwanted item from the temporary list before saving if needed.
- 4
When only valid items remain, select “เพิ่มเข้าคลัง” (Add to library) and confirm the save operation.
Step 5: Understand file status colors
![[Mockup placeholder: File list with green valid, yellow warning/duplicate, and red danger/error examples]](/uploads/mockups/add-songs-single-status.png)
[Mockup placeholder: File list with green valid, yellow warning/duplicate, and red danger/error examples]