Funkwhale
/
Clementine-audio-player-Mac-Linux-Windows
mirror of https://github.com/clementine-player/Clementine
1
0
Fork 0
Code Issues Releases Wiki Activity

Updated Cue Sheet Support (markdown)

davidsansome 2013-12-01 00:40:41 -08:00
parent 79618cdacb
commit 690ac3e85f
1 changed files with 8 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
Cue-Sheet-Support.md

@ -1,8 +1,6 @@
# CUE sheet support description
<wiki:toc max_depth="1" />
# Introduction
### Introduction
If you don't know what CUE is, you probably don't need to read this. Still, if you'd like to learn what CUE is, a good starting point would be this Wikipedia's article: [http://en.wikipedia.org/wiki/Cue_sheet_(computing)]. Before we start, check out CUEs in action!
@ -20,7 +18,7 @@ Notice that both songs that were described in the sheet appear in the playlist e
http://student.agh.edu.pl/~bara/cue_result.png
# Dictionary
### Dictionary
**CUE related song** - every song represented by a media file described with a CUE sheet. For example, song1.wav is CUE related:
@ -40,7 +38,7 @@ http://student.agh.edu.pl/~bara/cue_result.png
~/MUSIC/A_DJ/A_Mix/a_mix.mp3
~/MUSIC/A_DJ/A_Mix/a_mix.cue
# CUE sheets outside the library
### CUE sheets outside the library
When we're dealing with CUE sheets outside of the library, we're talking about the full spectrum of features. When loading CUE related songs using the 'Files' tab or dragging and dropping such songs from your native file browser:
@ -55,7 +53,7 @@ Also, when you're opening a media file, if Clementine finds an associated CUE, i
Please note one thing about the multiple FILE based CUEs: any given FILE should appear in a CUE file at most once!
# CUE sheets in library
### CUE sheets in library
Library supports ONLY the associated .cues which means you need to name your .cues just like their associated media files, otherwise library scanner won't recognize them.
@ -76,11 +74,11 @@ For example, in this situation...
Please note that when rescanning the library, a song is marked as changed (which means it'll get updated) when either it's media file has changed or it's associated CUE file has changed. Also, when a CUE sheet that was used by library song sections gets deleted, the associated song sections are deleted from it too and the only thing that's left is the 'raw' media file like there was no CUE support in the first place.
# Embedded CUEs
### Embedded CUEs
Embedded CUEs are currently not supported and won't be supported until at least 0.8 version of Clementine. If you'd really like to see this feature, vote for this issue: issue #1276
# CUEs and invalid media files
### CUEs and invalid media files
Some formats (like APE) are not recognized by the tag library which Clementine's using. That means you cannot load such files (let's call those 'invalid') into Clementine. Try dropping such a song into playlist - the request will be ignored.
@ -88,11 +86,11 @@ But... If you have a CUE related to such an invalid file, you'll be able to load
Keep in mind though that while you'll be able to load a CUE + invalid song pair into playlist, such a pair won't ever get into the library!
# Encoding
### Encoding
Unfortunately the CUE sheet standard is not specifying an encoding. There's a SLIGHT chance that Clementine will recognize any encoding out there... but if you don't want to see any weird characters in your tags, please convert all your CUEs to UTF because UTF (UTF-8 for example) is the only encoding family that's fully supported.
# Updating from Clementine 0.6 or earlier
### Updating from Clementine 0.6 or earlier
When upgrading from version 0.6 or earlier, Clementine will require a full library rescan to see your CUEs. The fact will be detected by the player and it will provide you with a handy dialog during the update: