iScrobbler » Discussions

iScrobbler Hidden Preferences (as of 2.0)

 
    • Damaged said...
    • User
    • 10 Jan 2007, 17:08

    iScrobbler Hidden Preferences (as of 2.0)

    This list may not be comprehensive.

    Warning

    These preferences are "hidden" for a reason and if you decide to change them you may get unexpected results or get iScrobbler into a state where it just stops working. If this occurs, the best thing to do is quit iScrobbler, and delete the preferences file located at:

    ~/Library/Preferences/org.bergstrand.iscrobbler.plist

    (Note: In versions older than 1.5b5, the preferences are accessed using org.flexistentialist.iscrobbler instead.

    To set:

    1) Quit iScrobbler

    2) Using Terminal:

    defaults write org.bergstrand.iscrobbler "Key" "value"

    For boolean values (true or false), add -bool before "value"

    To delete a key:

    defaults delete org.bergstrand.iscrobbler "Key"

    Keys

    Artist Detail Show Artist Detail drawer for the selected artist/track in the Top Lists window.
    Default: true

    Artwork Cache Size (Removed in 2.0+) Set the maximum number of cache slots. Must be 8 or greater. If set, iScrobbler will not try to auto-calculate the max based on installed RAM.
    Default: empty (auto-calculate)

    AutoLoveTracksRatedHigherThan Automatically love tracks with a rating higher than the given value. Warning: If this is enabled, a track will be loved every time it is played as iScrobbler does not check for existing loved tracks. This won't cause any problems with last.fm, but it will generate extra network traffic. An auto-love will not be submitted until the track itself has been submitted, so that a skipped track is not loved accidently. The default of 1000000 prevents any track from being auto-loved as valid iTunes ratings (scaled to the number of stars) are currently between 0 and 5.
    Default: 1000000
    Note: When setting, prefix the value with -int

    AutoTagLovedBanned Automatically tag Loved tracks as "loved" and Banned tracks as "banned".
    Default: false

    CheckForFileMBIDs Check MP3 files for MBIDs (Musicbrainz IDs).
    Default: true

    Disable Local Lists Disable all data tracking for local top lists.
    Default: false

    Display Control Menu Display the note menu in the menu bar. The note menu is the only UI entry point iScrobbler offers.
    Default: true

    GrowlLastFMCommunications (2.0+) Growl last.fm handshakes and submissions.
    Default: false

    GrowlPlays Show Growl message when a track begins playing
    Default: true

    GrowlOnResume Show Growl message when track play is resumed from a pause.
    Default: false

    GrowlPlayTitle Customize the title of the Growl play notification.
    Default:"%t" See GrowlPlayFormat below for format info.

    GrowlPlayFormat Customize the format of Growl messages.
    Default: "%a%n%A%n%d%n%r"

    Where:
    %A = album
    %a = artist
    %t = title
    %r = rating
    %d = elapsed time and duration (2.0+)
    %n = new line

    All other characters are passed through unmodified.

    IgnoreNetworkMonitor Don't monitor the network connection for availability.
    Default: false

    IgnorePodcasts Don't submit Podcasts downloaded from the iTunes Store (other Podcasts are not marked as such by iTunes).
    Default: false

    MenuNPInfoDelay (2.0+) The time required to hover the mouse over the control menu before the Growl track notification appears. In milliseconds (1000 = 1 second).
    Default: 1000

    Now Playing Detail Show Artist Detail drawer for the currently playing song in the Stats window. If 'Artist Detail' is false, this setting has no effect either way.
    Default: true

    PrimaryMenuColor (1.5.1+) Set the menu color for the "default" state of the iScrobbler menu. Valid values are limited to: "blackColor", "darkGrayColor", "lightGrayColor", "whiteColor", "grayColor", "blueColor", "cyanColor", "yellowColor", "magentaColor", "purpleColor", "brownColor"
    Default: "blackColor"

    QueueSubmissionsIfiPodIsMounted Queue tracks played in iTunes if an iPod is mounted. This allows you to play tracks in iTunes while an iPod is syncing and still have the iPod plays be submitted along with those played in iTunes. If you have Disk Mode set on your iPod you may want to change this to false, but beware that if you play something in iTunes before your iPod is done syncing the iPod plays will be lost.
    Default: true

    Radio Station History Limit (2.0+) If this is set, it overrides the 'Number of Songs to Save' pref in determining the number of stations in the radio history.
    Default: not set

    Track Filters Don't submit tracks matching these filters.
    Default: empty

    You can filter on artist name, genre and path. Paths can be as specific or general as you want (down to a specific file, or any parent folder) .

    Please note that these are keywords that are applied equally to Artist, Genre and path. So if you have an Artist and Genre with the same name, but only want to filter the Genre the Artist will be filtered too. Paths should generally not conflict with Artist/Genre. Also note, that path filters will likely not apply to tracks synced from an iPod in manual mode.

    Example:
    defaults write org.bergstrand.iscrobbler "Track Filters" '("Artist name", "Genre name", "/Absolute Path/To/Folder", ...)'

    The format of the argument list is important, make sure the list begins with '(, ends with )' and that each item is quoted. Remember that each filter applies equally to Artist, Genre and Path. One wrong word and you could filter out a bunch of tracks you didn't mean too. (This is why the preference is hidden -- it's too dangerous to be a supported option.)

    Use Batch Submission Submit tracks in batch mode. If false, submit tracks one at a time (not recommend for both submission rate performance and bandwidth reasons).
    Default: true

Anonymous users may not post messages. Please log in or create an account to post in the forums.