Did you know AmpJuke can scan a subset of your music collection ? Using the "last scanned" date makes scan+import run much faster. Read more.


What are the options in "Scan music" about ?


You - or whoever have administrator access - can click on "Scan music..." on the 'welcome' page to setup the scan+import process.

It looks similar to this:


A brief walk-through of the parameters, as follows:

Complain about missing permissions on folders: The scan+import process will loop through all folders starting from the "base" folder and beyond.
If it's impossible to read from a given folder, the scan+import process will stop and notify you about it, if this setting is checked.
Default: On (checked).

Delete "dead" records: If checked, the records in the AmpJuke-database will be checked against the filesystem, to see if there are any records that 'points' to a file that - for whatever reason - no longer exists on the filesystem.
In other words: A "synchronization" of records in your database against what's currently on your filesystem.
Default: Off (not checked).

Only scan+import tracks added after: If checked, and a valid date is entered in the correct format (YYYY-MM-DD), AmpJuke will only scan+import tracks added/modified after the date.
In other words: If you only wish to scan+import music added after a specific date, this option can come in handy.
Please note that enabling this setting has a huge impact on speed in relation to how fast scan+import will run.
Default: Off, the first time. On with a default date of last time a scan+import was done.

Don't import a track if the bitrate is below: If checked, tracks with a bitrate below the bitrate entered in the field will not be imported.
Note that the value is entered as an integer, - if you f.ex. enter 128000, then tracks with a bitrate below 128 kbps. (approximately) will not be imported.
Tracks encoded with VBR actually does have a bitrate (the average?) stored in the tags, which will be used as the general bitrate for a particular track.
Tracks with CBR and ABR also have a bitrate in the tags.
Deafult: Off (not checked) and 32000 (approx. 32 kbps.) as the value.

Re-process tracks found in database AND on the filesystem: If checked, a track which already has its tags in the database will be re-processed - it will be classified as "new" and (re-)processed together with any "real" new tracks.
Enabling this setting causes tracks imported earlier with some kind of error - f.ex. a misspelled album name - to be re-processed, which most likely will correct the error (f.ex. the before mentioned misspelling) introduced in the database during an earlier scan+import session.
Important note: If a track is considered "too old" ("Only scan+import tracks added after..." is active, see above) or the bitrate limit is activated (previous setting), no re-processing will happen.
Default: Off (not checked).



Look for covers in folders: If checked and each time a new album is discovered during scan+import, a search for a cover within the folder where the album is located will take place.

In order to take full advantage of this setting, some kind of organization of albums is needed...

Default: Off (not checked).

Simulate import (don't change database or DO anything): Aka. "the option for sissies"...
If checked, a scan+import will be simulated.
In other words: Nothing will change in your database and no new/updated music will be imported and/or re-processed.
Even "dead" records won't be removed (if activated, see 'Delete "dead" records' above).
AmpJuke's scan+import process will just loop through your music, tell what needs to be told (based on the other parameters) and generate a report.
I have to admit that even I am a sissy from time to time, so simulating a scan+import might be a good idea if you just want to get an idea of the impact when running a scan+import.
Important note: Assume the scan+import routine finds a new album. If it does, the album will considered "new" for all tracks that belong to that particular album (i.e.: You will get many notifications that the album is new). This will only happen if you have "Simulate import" turned on. If you do a scan+import for real, the new album name will only be added once to the database. The same is true with new performers/artists.
Deafult: Off (not checked).

Show details during scan+import: Select what level of detail you want displayed on-screen when scan+import is running. There are 4 different to choose among.
The "Very detailed" level is only recommended if you really want to see what's going on during the process, since a lot of stuff will be written to the screen...
Default: "Normal".

The next 7 parameters tells what AmpJuke should do if/when one or more tags of a certain type is missing on your music-files.

...a missing track-number is: 'a warning', 'an error' or 'OK'. Default: 'a warning'.

...a missing year is: 'a warning', 'an error' or 'OK'. Default: 'a warning'.

...a missing album name is: 'a warning', 'an error' or 'OK'. Default: 'OK'.

...a missing performer is: 'a warning', 'an error' or 'OK'. Default: 'an error'.

...a missing track name is: 'a warning', 'an error' or 'OK'. Default: 'an error'.


Display a link to edit tags: This setting is rather new in AmpJuke...

If checked, it will be possible to edit the tags of the tracks that might have "problems" in relation to getting scanned+imported successfully to the database. If enabled (checked) a little "Edit" link will be shown next to track(s) that for whatever reason fails to be imported during scan+import.

The link will be visible in the scan report that's generated after scan+import is finished.

Import warnings to the database: If checked, a track will be imported to the database, even if the track contains tags that causes a warning to be issued (see above), f.ex. an emtpy track-number.
Default: Off (not checked).

Import errors to the database: If checked, a track will be imported to the database, even if the track contains tags that causes an error to be issued (see above), f.ex. an empty track name.
Default: Off (not checked).

Set the parameters described above according to your preference, click "Start scan+import", and wait until the process is finished.
Depending on the size of your music-collection, the chosen parameters and the speed of your box, a scan+import might take very long time to complete, so please be patient.

Once finished, a report is generated about what just happened during scan+import.
Note that the report will also be generated if you have Simulate import turned on.
Please remember that when "simulate import" is turned on, some of the figures in the report are wrong - see notes in relation to this under "Simulate import" above.
Figures such as number of folders processed, folders not read, total number of tracks processed, new tracks discovered, errors and warnings will be included in the report.
Furthermore, various lists of the tracks that are new, have warnings, have errors etc. is also included in the report.