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

Remove broken links to images

Shane Bell 2014-05-06 03:37:19 -07:00
parent af5f17d713
commit a56d1f69c5
1 changed files with 0 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Library-Scanning.md

@ -2,8 +2,6 @@
When you first add a folder to your library in the Preferences dialog, Clementine will scan it and all it's subfolders looking for media files. Every correct media file will get into your library with all of it's metadata, whether the metadata is coming from the media file itself (things like ID3 tags) or from another source like is the case with CUE associated songs.
http://student.agh.edu.pl/~bara/new_library_folder.png
All the metadata goes straight into your Clementine's database. The database is the heart of Clementine. It let's us, developers, provide you with features like a view of your songs in form of a tree-like structure (that's the Library view), fast lookup of songs you need, ability to create smart playlists filtered by various conditions etc.
Of course, most of the data in the database can and will change with time. You can do things like: update a song's metadata, move an album under 'Various artists', change it's cover art or you can just play music. The last one affects the database because we're keeping things like the last played time, play count and score there.
@ -14,8 +12,6 @@ Remember that when you're removing a folder from library, you're also removing a
In "Preferences / Music Library", there's a "Monitor library for changes" option.
http://student.agh.edu.pl/~bara/monitor_for_changes.png
Turning it on will make Clementine watch your library FOLDERs for changes. If a folder monitor notifies Clementine of change, the player will rescan that directory and all of it's subdirectories.
During a scan, only the files for which their mtime (modification time) has changed since the last scan, will get examined. This of course includes files not yet in the library and those library files which got deleted. Other library songs won't go through any changes.
@ -33,24 +29,18 @@ Also, remember that if you have "Monitor library for changes" option off, you'll
# Update changed library folders
http://student.agh.edu.pl/~bara/update.png
This menu option scans all your library roots in search for changes. If it finds a change in a folder's mtime, the scan goes deeper. This of course suffers from the same issues that were described above - the depth of search depends on modification times of folders.
You should treat the feature like a helper and not the ultimate problem solver. It's lightweight but in some cases won't help Clementine see the changes you made (especially using some external tool).
The workarounds above apply here too but to make them fully work you'd need to apply those on every level of the tree of your library folders.
http://student.agh.edu.pl/~bara/update_on_start.png
This type of scan is launched during Clementine's startup, when you have the "Update the library when Clementine starts" option on ("Preferences / Music Library").
# Do a full library rescan
This feature is your last resort will-work-in-any-circumstances friend.
http://student.agh.edu.pl/~bara/full_rescan.png
This type of scan treats every folder it goes through and every file in all of the folders like they've changed since the last scan which of course means, everything will get updated to the current version. The most important thing here is, your statistics (like rating or playcount) will be preserved.
The full collection rescan goes through all your library roots and all of their subfolders. Obviously this might take some time, especially when your library is huge but still we'd recommend doing a full rescan every now and then.