Package com.tagtraum.ubermusic.beatport
Class BeatportTrack
- java.lang.Object
-
- com.tagtraum.audiokern.ReadOnlyAudioSong
-
- com.tagtraum.ubermusic.beatport.BeatportTrack
-
- All Implemented Interfaces:
AudioSong,Comparable<BeatportTrack>
public class BeatportTrack extends ReadOnlyAudioSong implements Comparable<BeatportTrack>
Beatport track.- Author:
- Hendrik Schreiber
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.tagtraum.audiokern.AudioSong
AudioSong.CloudStatus, AudioSong.Instrumentation, AudioSong.Liking, AudioSong.MediaKind, AudioSong.TrackType
-
-
Field Summary
-
Fields inherited from interface com.tagtraum.audiokern.AudioSong
ACOUSTIC_NAMES, ELECTRONIC_NAMES
-
-
Constructor Summary
Constructors Constructor Description BeatportTrack(org.json.simple.JSONObject json)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancanWrite()Checks whether the file corresponding to this song can in principal be written to.intcompareTo(BeatportTrack o)voiddownload()Allows downloading of shared (e.g.StringgetAlbum()Get Album.StringgetAlbumArtist()Get album artist.Set<AudioId>getAlbumIds()Get album ids.intgetAlbumRating()Get album rating.ReplayGaingetAlbumReplayGain()Replay gain for this album.StringgetArtist()Get artist.Set<AudioId>getArtistIds()Get artists ids.intgetArtworkCount()Get artwork count.AudioArtwork[]getArtworks()Artwork belonging to this song.ImagegetBackCoverImage()Returns the first front cover image.BeatsgetBeats()The song's beats.StringgetBeatsAlgorithm()Method the beats were computed with.floatgetBeatsPerMinute()Beats per minute (BPM).StringgetBeatsPerMinuteAlgorithm()Returns the name of the algorithm used to determine the beats per minute (BPM).intgetBitRate()Bit rate.AudioSong.CloudStatusgetCloudStatus()Returns the cloud status, if available.ColorgetColor()Returns the color.StringgetComments()Get comments.StringgetComposer()Get composer(s).StringgetContentRating()Returns the content rating.StringgetCustom1()Custom field.StringgetCustom2()Custom field.StringgetCustom3()Custom field.StringgetCustom4()Custom field.StringgetCustom5()Custom field.FloatgetDanceability()Danceability.StringgetDanceabilityAlgorithm()Returns the name of the danceability algorithm.DategetDateAdded()Get date the song was added to the library.DategetDateAnalyzed()Date the song was last analyzed.DategetDateModified()Get date of last modification.StringgetDescription()Description/subtitle of this song.intgetDiscCount()Assuming that this song is on a disc that is part of a disc collection, return the number of discs in this collection.intgetDiscNumber()Get the disc number.StringgetEpisode()Get episode name.intgetEpisodeOrder()Episode order.PathgetFile(boolean refresh)File of this track.byte[]getFingerprint()Acoustic fingerprint.floatgetFinish()Stop time of the song in seconds.ImagegetFrontCoverImage()Returns the first front cover image.StringgetGenre()Get genre.StringgetGrouping()Get grouping.LonggetId()Persistent id.ImagegetImage()First artwork image.Image[]getImages()All images.AudioSong.InstrumentationgetInstrumentation()Indicates whether this song qualifies as "electronic" or "acoustic".StringgetInstrumentationAlgorithm()Returns the name of the instrumentation algorithm.KeygetKey()Return the tonal key of this song.StringgetKeyAlgorithm()Returns the name of the key algorithm.StringgetKind()Kind of audio, e.g.StringgetLanguage()The language of the lyrics as ISO 639 three letter codes.StringgetLocation(boolean refresh)Location of this track.LoudnessgetLoudness()The song's loudness curve.StringgetLyrics()Returns the lyrics.List<TermFrequency>getLyricsTermFrequencies()Terms in this song's lyrics along with their frequency.floatgetMeasuresPerMinute()Measures (bars) per minute.AudioSong.MediaKindgetMediaKind()Media kind of this object.MoodgetMood()The song's mood.StringgetMoodAlgorithm()The method the associated mood value was created with.Set<String>getMoodKeywords()Get raw mood keywords.StringgetMovement()Classical movement.intgetMovementCount()Classical movement count.intgetMovementNumber()Classical movement number.StringgetName()Name of this song.StringgetPath()Path.intgetPlayCount()Get the number of times the song was played.longgetPlayDate()Get time the song was last played.DategetPlayDateUTC()Get play date.doublegetPlayFrequency()Number of times played per 100 days.doublegetPlaySkipRatio()Play/Skip ratio.intgetPosition()URLgetPurchaseURL()URL for a website/service that allows users to purchase this song.intgetRating()Value ranging from 0-100, 100 being best.FloatgetRelativeSpectralEntropyMean()Average of relative entropy values computed for windows of length 1.486s with a hopsize of half a window.DategetReleaseDate()Release year (corresponds to id3 TDRL).FloatgetRMSMean()Root mean square (RMS) of the signal's energy, averaged over windows of length ~23ms (actually 1024/44100 frames for a signal with sample rate 44.1kHz, i.e.FloatgetRMSStandardDeviation()Standard deviation of the root mean square energy values for windows of length ~23ms (actually 1024/44100 frames for a signal with sample rate 44.1kHz) with a hopsize of half a window.intgetSampleRate()Get sample rate in Hz.intgetSeason()Get season number.SegmentsgetSegments()The song's segments.StringgetSegmentsAlgorithm()Method the segments were computed with.StringgetShow()Name of a show, suitable for TV shows.SimilaritiesgetSimilarities()The song's similarities.StringgetSimilaritiesAlgorithm()Method the similarities were computed with.longgetSize()File size.intgetSkipCount()Get skip count.DategetSkipDate()Get skip date.StringgetSortAlbum()Returns the "sort album".StringgetSortAlbumArtist()Returns the "sort album artist".StringgetSortArtist()Returns the "sort artist".StringgetSortComposer()Returns the sort composer.StringgetSortName()Returns the "sort name".StringgetSortShow()Returns the sort show.FloatgetSpectralCentroidMean()Average of the spectral centroids computed for individual windows of length ~23.22ms with a hopsize of half a window length.FloatgetSpectralFluctuationPeak()Peak of the averaged spectral fluctuation values computed for windows of length 23.22ms, with a hopsize of half a window.FloatgetSpectralFluxMean()Average of the spectral flux values computed for windows of length 23.22ms, with a hopsize of half a window.FloatgetSpectralNoveltyMean()Average of the spectral novelty values computed for windows of length 23.22ms, with a hopsize of half a window.FloatgetSpectralSpreadMean()Average of the spectral spread values computed for windows of length 23.22ms, with a hopsize of half a window.FloatgetSpectralVariabilityMean()Average of the spectral variability values computed for windows of length 23.22ms, with a hopsize of half a window.com.tagtraum.audiokern.timbre.BarkSpectrumgetSpectrum()Returns the bark spectrum.floatgetStart()Start time of the song in seconds.intgetStartTime()Start time of the song in ms.intgetStopTime()Stop time of the song in ms.Set<String>getTags()Returns a set of tags associated with this song.com.tagtraum.audiokern.bpm.TempogetTempo()Returns tempo.ColorgetTempoColor()Projection ofAudioSong.getTempoSpectrum()to a color.com.tagtraum.audiokern.bpm.TempoSpectrumgetTempoSpectrum()Returns the tempo spectrum.ColorgetTempoTimbreColor()Projection ofAudioSong.getTempoSpectrum()andAudioSong.getSpectrum()to a color.TimeSignaturegetTimeSignature()The song's time signature.StringgetTimeSignatureAlgorithm()Method the time signature was computed with.intgetTotalTime()Total length of the song in ms.intgetTrackCount()Number of tracks on album/release/recording.Set<AudioId>getTrackIds()Returns track ids.intgetTrackNumber()Get the number of the track on the release/album/recording.ReplayGaingetTrackReplayGain()Replay gain for this track (not taking other tracks in an album into account).AudioSong.TrackTypegetTrackType()Track type.IntegergetTuning()Tuning in cents.StringgetTuningAlgorithm()The method the current tuning was created with.intgetVolumeAdjustment()Value between -255 and 255.StringgetWork()Classical work.intgetYear()Release year - (corresponds to id3 TDRC, recording time).booleanhasProtectedFileExtension()Checks file endings instead of the protected flag in the iTunes Music Library.xml, since iTunes marks non-protected versions of files that used to be protected still as protected.booleanisAlbumRatingComputed()Indicates whether the value returned byAudioSong.getAlbumRating()was computed or set manually.booleanisClean()Indicates whether this song is "clean" - whatever that means.booleanisCompilation()Indicates whether this track is part of a compilation.booleanisDisabled()Indicates whether this song is disabled or unchecked.booleanisEnabled()Indicates whether this song is enabled or checked.booleanisExplicit()Indicates whether this tracks is explicit or not.booleanisHasVideo()Indicates whether this track has a video.booleanisHD()Indicates whether this video content is in high definition (HD).booleanisPartOfGaplessAlbum()Indicates whether this songs is part of a gapless album.booleanisProtected()booleanisPurchased()Indicates whether this song was purchased (via the iTunes store).booleanisRatingComputed()Indicates whether the value returned byAudioSong.getRating()was computed or set manually.booleanisShared()Indicates whether this track is a shared track, i.e.booleanisUnplayed()Indicates whether this songs has been played at some point.voidsetPosition(int position)StringtoString()-
Methods inherited from class com.tagtraum.audiokern.ReadOnlyAudioSong
addArtwork, addPropertyChangeListener, addPropertyChangeListener, getImplementation, getImplementations, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener, setAlbum, setAlbumArtist, setAlbumLiking, setAlbumRating, setAlbumReplayGain, setArtist, setArtworks, setBackCoverArtwork, setBeats, setBeatsAlgorithm, setBeatsPerMinute, setBeatsPerMinuteAlgorithm, setClean, setColor, setComments, setCompilation, setComposer, setContentRating, setCustom1, setCustom2, setCustom3, setCustom4, setCustom5, setDanceability, setDanceabilityAlgorithm, setDateAnalyzed, setDescription, setDisabled, setDiscCount, setDiscNumber, setEnabled, setEpisode, setEpisodeOrder, setExplicit, setFingerprint, setFinish, setFrontCoverArtwork, setGenre, setGrouping, setHasVideo, setHD, setInstrumentation, setInstrumentationAlgorithm, setKey, setKeyAlgorithm, setKind, setLanguage, setLiking, setLocation, setLoudness, setLyrics, setMediaKind, setMood, setMoodAlgorithm, setMoodKeywords, setMovement, setMovementCount, setMovementNumber, setName, setPartOfGaplessAlbum, setPlayCount, setPlayDate, setPlayDateUTC, setPopularity, setRating, setRelativeSpectralEntropyMean, setReleaseDate, setRemoteDisliked, setRemoteLoved, setRemotePlayFrequency, setRemotePlaySkipRatio, setRemoteRating, setRemoteUpdateDate, setRMSMean, setRMSStandardDeviation, setSeason, setSegments, setSegmentsAlgorithm, setShow, setSimilarities, setSimilaritiesAlgorithm, setSkipCount, setSkipDate, setSortAlbum, setSortAlbumArtist, setSortArtist, setSortComposer, setSortName, setSortShow, setSpectralCentroidMean, setSpectralFluctuationPeak, setSpectralFluxMean, setSpectralNoveltyMean, setSpectralSpreadMean, setSpectralVariabilityMean, setSpectrum, setStart, setStartTime, setStopTime, setTags, setTempo, setTempoColor, setTempoSpectrum, setTempoTimbreColor, setTimeSignature, setTimeSignatureAlgorithm, setTrackCount, setTrackNumber, setTrackReplayGain, setTrackType, setTuning, setTuningAlgorithm, setUnplayed, setVolumeAdjustment, setWork, setYear
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.tagtraum.audiokern.AudioSong
addBackCoverArtwork, addFrontCoverArtwork, getAlbumLiking, getFile, getInstrumentationBasedOnGenreAndTags, getLiking, getLocation, getPopularity, getRemoteDisliked, getRemoteLoved, getRemotePlayFrequency, getRemotePlaySkipRatio, getRemoteRating, getRemoteUpdateDate, getSyncTempoKey, getSyncTempoTuning, isAcousticBasedOnGenreTitleAndTags, isElectronicBasedOnGenreAndTags, refreshFromFile
-
-
-
-
Method Detail
-
compareTo
public int compareTo(BeatportTrack o)
- Specified by:
compareToin interfaceComparable<BeatportTrack>
-
getMediaKind
public AudioSong.MediaKind getMediaKind()
Description copied from interface:AudioSongMedia kind of this object.- Specified by:
getMediaKindin interfaceAudioSong- Returns:
- kind of media
-
isShared
public boolean isShared()
Description copied from interface:AudioSongIndicates whether this track is a shared track, i.e. either from another iTunes library or an iTunes Match song that hasn't been downloaded yet.
-
download
public void download()
Description copied from interface:AudioSongAllows downloading of shared (e.g. podcasts) or iCloud tracks. May not be available on Windows.
You may be notified of a change in download status of a track by registering a
PropertyChangeListenerfor one of the propertiesshared,trackTypeorlocation.- Specified by:
downloadin interfaceAudioSong- See Also:
AudioSong.isShared(),AudioSong.getTrackType(),AudioSong.getCloudStatus()
-
getCloudStatus
public AudioSong.CloudStatus getCloudStatus()
Description copied from interface:AudioSongReturns the cloud status, if available. Note that this call may be expensive, as it requires calling the iTunes API.- Specified by:
getCloudStatusin interfaceAudioSong- Returns:
- the status if available,
null, if the feature is not supported (Windows, non-iTunes libraries, ...)
-
getDescription
public String getDescription()
Description copied from interface:AudioSongDescription/subtitle of this song.- Specified by:
getDescriptionin interfaceAudioSong- Returns:
- description
-
getAlbumArtist
public String getAlbumArtist()
Description copied from interface:AudioSongGet album artist.- Specified by:
getAlbumArtistin interfaceAudioSong- Returns:
- album artist
-
getMovement
public String getMovement()
Description copied from interface:AudioSongClassical movement.- Specified by:
getMovementin interfaceAudioSong- Returns:
- movement
-
getMovementNumber
public int getMovementNumber()
Description copied from interface:AudioSongClassical movement number.- Specified by:
getMovementNumberin interfaceAudioSong- Returns:
- movement number
-
getMovementCount
public int getMovementCount()
Description copied from interface:AudioSongClassical movement count.- Specified by:
getMovementCountin interfaceAudioSong- Returns:
- count
-
getComposer
public String getComposer()
Description copied from interface:AudioSongGet composer(s).- Specified by:
getComposerin interfaceAudioSong- Returns:
- composer(s)
-
getGrouping
public String getGrouping()
Description copied from interface:AudioSongGet grouping.- Specified by:
getGroupingin interfaceAudioSong- Returns:
- grouping
-
getKind
public String getKind()
Description copied from interface:AudioSongKind of audio, e.g. "WAV audio file", "AAC audio file" or "MPEG audio file" (or localized versions thereof). This value is typically extracted fromiTunes Music Library.xmland may simply benullfor non-iTunes libraries.
-
getSize
public long getSize()
Description copied from interface:AudioSongFile size.
-
getTotalTime
public int getTotalTime()
Description copied from interface:AudioSongTotal length of the song in ms.- Specified by:
getTotalTimein interfaceAudioSong- Returns:
- length in ms.
-
getTrackCount
public int getTrackCount()
Description copied from interface:AudioSongNumber of tracks on album/release/recording.- Specified by:
getTrackCountin interfaceAudioSong- Returns:
- track count
- See Also:
AudioSong.getTrackNumber()
-
getStartTime
public int getStartTime()
Description copied from interface:AudioSongStart time of the song in ms.- Specified by:
getStartTimein interfaceAudioSong- Returns:
- start time in ms.
-
getStopTime
public int getStopTime()
Description copied from interface:AudioSongStop time of the song in ms.- Specified by:
getStopTimein interfaceAudioSong- Returns:
- stop time in ms.
-
getStart
public float getStart()
Description copied from interface:AudioSongStart time of the song in seconds.- Specified by:
getStartin interfaceAudioSong- Returns:
- start time in seconds.
- See Also:
AudioSong.getStartTime()
-
getFinish
public float getFinish()
Description copied from interface:AudioSongStop time of the song in seconds.- Specified by:
getFinishin interfaceAudioSong- Returns:
- stop time in seconds.
- See Also:
AudioSong.getStopTime()
-
getPosition
public int getPosition()
-
setPosition
public void setPosition(int position)
-
getTrackNumber
public int getTrackNumber()
Description copied from interface:AudioSongGet the number of the track on the release/album/recording.- Specified by:
getTrackNumberin interfaceAudioSong- Returns:
- track number
-
getDiscNumber
public int getDiscNumber()
Description copied from interface:AudioSongGet the disc number.- Specified by:
getDiscNumberin interfaceAudioSong- Returns:
- disc number
-
getDiscCount
public int getDiscCount()
Description copied from interface:AudioSongAssuming that this song is on a disc that is part of a disc collection, return the number of discs in this collection.- Specified by:
getDiscCountin interfaceAudioSong- Returns:
- disc count
-
getYear
public int getYear()
Description copied from interface:AudioSongRelease year - (corresponds to id3 TDRC, recording time).- Specified by:
getYearin interfaceAudioSong- Returns:
- four digit recording year, if available
- See Also:
AudioSong.getReleaseDate()
-
getDateModified
public Date getDateModified()
Description copied from interface:AudioSongGet date of last modification.- Specified by:
getDateModifiedin interfaceAudioSong- Returns:
- date
-
getDateAdded
public Date getDateAdded()
Description copied from interface:AudioSongGet date the song was added to the library.- Specified by:
getDateAddedin interfaceAudioSong- Returns:
- date added
-
getDateAnalyzed
public Date getDateAnalyzed()
Description copied from interface:AudioSongDate the song was last analyzed.- Specified by:
getDateAnalyzedin interfaceAudioSong- Returns:
- date analyzed
-
getBitRate
public int getBitRate()
Description copied from interface:AudioSongBit rate.- Specified by:
getBitRatein interfaceAudioSong- Returns:
- bit rate
-
getSampleRate
public int getSampleRate()
Description copied from interface:AudioSongGet sample rate in Hz.- Specified by:
getSampleRatein interfaceAudioSong- Returns:
- sample rate in Hz
-
getVolumeAdjustment
public int getVolumeAdjustment()
Description copied from interface:AudioSongValue between -255 and 255.- Specified by:
getVolumeAdjustmentin interfaceAudioSong- Returns:
- volume adjustment
-
getTrackReplayGain
public ReplayGain getTrackReplayGain()
Description copied from interface:AudioSongReplay gain for this track (not taking other tracks in an album into account).- Specified by:
getTrackReplayGainin interfaceAudioSong- Returns:
- replay gain
- See Also:
- "Radio" replay gain
-
getAlbumReplayGain
public ReplayGain getAlbumReplayGain()
Description copied from interface:AudioSongReplay gain for this album.- Specified by:
getAlbumReplayGainin interfaceAudioSong- Returns:
- replay gain
- See Also:
- "Audiophile" replay gain,
AudioSong.getTrackReplayGain()
-
getComments
public String getComments()
Description copied from interface:AudioSongGet comments.- Specified by:
getCommentsin interfaceAudioSong- Returns:
- comments
-
getPlayCount
public int getPlayCount()
Description copied from interface:AudioSongGet the number of times the song was played.- Specified by:
getPlayCountin interfaceAudioSong- Returns:
- play count
-
getPlayDate
public long getPlayDate()
Description copied from interface:AudioSongGet time the song was last played. Returns0, if it has never been played.- Specified by:
getPlayDatein interfaceAudioSong- Returns:
- play date, milliseconds since January 1, 1970, 00:00:00 GMT (NOT related to the iTunes value!)
-
getPlayDateUTC
public Date getPlayDateUTC()
Description copied from interface:AudioSongGet play date.- Specified by:
getPlayDateUTCin interfaceAudioSong- Returns:
- play date
-
getSkipCount
public int getSkipCount()
Description copied from interface:AudioSongGet skip count.- Specified by:
getSkipCountin interfaceAudioSong- Returns:
- skip count
-
getSkipDate
public Date getSkipDate()
Description copied from interface:AudioSongGet skip date.- Specified by:
getSkipDatein interfaceAudioSong- Returns:
- skip date
-
getReleaseDate
public Date getReleaseDate()
Description copied from interface:AudioSongRelease year (corresponds to id3 TDRL).- Specified by:
getReleaseDatein interfaceAudioSong- Returns:
- release time
-
getCustom1
public String getCustom1()
Description copied from interface:AudioSongCustom field.- Specified by:
getCustom1in interfaceAudioSong- Returns:
- custom field
-
getCustom2
public String getCustom2()
Description copied from interface:AudioSongCustom field.- Specified by:
getCustom2in interfaceAudioSong- Returns:
- custom field
-
getCustom3
public String getCustom3()
Description copied from interface:AudioSongCustom field.- Specified by:
getCustom3in interfaceAudioSong- Returns:
- custom field
-
getCustom4
public String getCustom4()
Description copied from interface:AudioSongCustom field.- Specified by:
getCustom4in interfaceAudioSong- Returns:
- custom field
-
getCustom5
public String getCustom5()
Description copied from interface:AudioSongCustom field.- Specified by:
getCustom5in interfaceAudioSong- Returns:
- custom field
-
getArtworkCount
public int getArtworkCount()
Description copied from interface:AudioSongGet artwork count.- Specified by:
getArtworkCountin interfaceAudioSong- Returns:
- artwork count
-
getImage
public Image getImage()
Description copied from interface:AudioSongFirst artwork image.- Specified by:
getImagein interfaceAudioSong- Returns:
- first artwork image of this track.
- See Also:
AudioSong.getFrontCoverImage(),AudioSong.getBackCoverImage()
-
getRating
public int getRating()
Description copied from interface:AudioSongValue ranging from 0-100, 100 being best.- Specified by:
getRatingin interfaceAudioSong- Returns:
- rating
- See Also:
AudioSong.isRatingComputed(),AudioSong.getAlbumRating()
-
getAlbumRating
public int getAlbumRating()
Description copied from interface:AudioSongGet album rating.- Specified by:
getAlbumRatingin interfaceAudioSong- Returns:
- album rating
- See Also:
AudioSong.isAlbumRatingComputed()
-
isRatingComputed
public boolean isRatingComputed()
Description copied from interface:AudioSongIndicates whether the value returned byAudioSong.getRating()was computed or set manually.- Specified by:
isRatingComputedin interfaceAudioSong- Returns:
trueorfalse
-
isAlbumRatingComputed
public boolean isAlbumRatingComputed()
Description copied from interface:AudioSongIndicates whether the value returned byAudioSong.getAlbumRating()was computed or set manually.- Specified by:
isAlbumRatingComputedin interfaceAudioSong- Returns:
trueorfalse
-
getShow
public String getShow()
Description copied from interface:AudioSongName of a show, suitable for TV shows.
-
getSeason
public int getSeason()
Description copied from interface:AudioSongGet season number. Suitable for TV-shows.
-
getEpisode
public String getEpisode()
Description copied from interface:AudioSongGet episode name.- Specified by:
getEpisodein interfaceAudioSong- Returns:
- episode name
-
getEpisodeOrder
public int getEpisodeOrder()
Description copied from interface:AudioSongEpisode order.- Specified by:
getEpisodeOrderin interfaceAudioSong- Returns:
- episode order
-
isCompilation
public boolean isCompilation()
Description copied from interface:AudioSongIndicates whether this track is part of a compilation.
"A compilation album is an album (music or spoken-word) featuring tracks from one or more performers, often culled from a variety of sources (such as studio albums, live albums, singles, demos and outtakes.)"
-- Wikipedia Album Compliation- Specified by:
isCompilationin interfaceAudioSong- Returns:
trueorfalse
-
getId
public Long getId()
Description copied from interface:AudioSongPersistent id. Survives application shutdown.
-
isEnabled
public boolean isEnabled()
Description copied from interface:AudioSongIndicates whether this song is enabled or checked.
-
isDisabled
public boolean isDisabled()
Description copied from interface:AudioSongIndicates whether this song is disabled or unchecked.- Specified by:
isDisabledin interfaceAudioSong- Returns:
- !
AudioSong.isEnabled()
-
getTrackType
public AudioSong.TrackType getTrackType()
Description copied from interface:AudioSongTrack type. E.g.AudioSong.TrackType.FILE.- Specified by:
getTrackTypein interfaceAudioSong- Returns:
- track type
- See Also:
AudioSong.setTrackType(TrackType)
-
isUnplayed
public boolean isUnplayed()
Description copied from interface:AudioSongIndicates whether this songs has been played at some point.- Specified by:
isUnplayedin interfaceAudioSong- Returns:
trueorfalse
-
isClean
public boolean isClean()
Description copied from interface:AudioSongIndicates whether this song is "clean" - whatever that means. "Clean" and "explicit" are mutually exclusive.- Specified by:
isCleanin interfaceAudioSong- Returns:
trueorfalse- See Also:
AudioSong.isExplicit()
-
isHasVideo
public boolean isHasVideo()
Description copied from interface:AudioSongIndicates whether this track has a video.- Specified by:
isHasVideoin interfaceAudioSong- Returns:
trueorfalse
-
isProtected
public boolean isProtected()
Description copied from interface:AudioSong- Specified by:
isProtectedin interfaceAudioSong- Returns:
trueorfalse
-
getLocation
public String getLocation(boolean refresh)
Description copied from interface:AudioSongLocation of this track. Ifrefreshis true and no location is available or the resource does not exist anymore, ask the backend app (iTunes, Music.app, ...) for the correct path. Because of the backend call, this method may block and therefore should be called from the EDT.- Specified by:
getLocationin interfaceAudioSong- Parameters:
refresh- refresh from backend- Returns:
- location
- See Also:
AudioSong.getLocation(),AudioSong.getFile(boolean)
-
getPurchaseURL
public URL getPurchaseURL()
Description copied from interface:AudioSongURL for a website/service that allows users to purchase this song.- Specified by:
getPurchaseURLin interfaceAudioSong- Returns:
- store URL or
null, if none is known
-
isPartOfGaplessAlbum
public boolean isPartOfGaplessAlbum()
Description copied from interface:AudioSongIndicates whether this songs is part of a gapless album.- Specified by:
isPartOfGaplessAlbumin interfaceAudioSong- Returns:
trueorfalse
-
isExplicit
public boolean isExplicit()
Description copied from interface:AudioSongIndicates whether this tracks is explicit or not. "Clean" and "explicit" are mutually exclusive.- Specified by:
isExplicitin interfaceAudioSong- Returns:
trueorfalse- See Also:
AudioSong.isClean()
-
isHD
public boolean isHD()
Description copied from interface:AudioSongIndicates whether this video content is in high definition (HD).
-
getSortArtist
public String getSortArtist()
Description copied from interface:AudioSongReturns the "sort artist". E.g., for "The Beatles" the sort artist is "Beatles".- Specified by:
getSortArtistin interfaceAudioSong- Returns:
- sort artist
-
getSortAlbum
public String getSortAlbum()
Description copied from interface:AudioSongReturns the "sort album". E.g., for "A Hard Day's Night" the sort album is "Hard Day's Night".- Specified by:
getSortAlbumin interfaceAudioSong- Returns:
- sort album
-
getSortName
public String getSortName()
Description copied from interface:AudioSongReturns the "sort name". E.g., for "A Taste of Honey" the sort name is "Taste of Honey".- Specified by:
getSortNamein interfaceAudioSong- Returns:
- sort name
-
getSortAlbumArtist
public String getSortAlbumArtist()
Description copied from interface:AudioSongReturns the "sort album artist". E.g., for "The Beatles" the sort album artist is "Beatles".- Specified by:
getSortAlbumArtistin interfaceAudioSong- Returns:
- sort album artist
-
getSortComposer
public String getSortComposer()
Description copied from interface:AudioSongReturns the sort composer.- Specified by:
getSortComposerin interfaceAudioSong- Returns:
- sort composer
-
getSortShow
public String getSortShow()
Description copied from interface:AudioSongReturns the sort show.- Specified by:
getSortShowin interfaceAudioSong- Returns:
- sort show
-
getContentRating
public String getContentRating()
Description copied from interface:AudioSongReturns the content rating. E.g., "us-tv|TV-PG|400|" or "us-tv|TV-MA|600|dialogue and sexual content"- Specified by:
getContentRatingin interfaceAudioSong- Returns:
- content rating
-
isPurchased
public boolean isPurchased()
Description copied from interface:AudioSongIndicates whether this song was purchased (via the iTunes store).- Specified by:
isPurchasedin interfaceAudioSong- Returns:
trueorfalse
-
getPlayFrequency
public double getPlayFrequency()
Description copied from interface:AudioSongNumber of times played per 100 days.- Specified by:
getPlayFrequencyin interfaceAudioSong- Returns:
- played per 100 days
- See Also:
AudioSong.getRemotePlayFrequency()
-
getPlaySkipRatio
public double getPlaySkipRatio()
Description copied from interface:AudioSongPlay/Skip ratio. Defined asplayCount/(skipCount+1).- Specified by:
getPlaySkipRatioin interfaceAudioSong- Returns:
- playSkip ratio as defined above
- See Also:
AudioSong.getRemotePlaySkipRatio(),AudioSong.getPopularity()
-
getFile
public Path getFile(boolean refresh)
Description copied from interface:AudioSongFile of this track. Ifrefreshis true and the file does not exist anymore, ask the backend app (iTunes, Music.app, ...) for the correct file name. Because of the backend call, this method may block and therefore should be called from the EDT.- Specified by:
getFilein interfaceAudioSong- Parameters:
refresh- refresh from backend- Returns:
- file object for
AudioSong.getLocation()or null, if a proper file object cannot be formed - See Also:
AudioSong.getLocation(),AudioSong.getLocation(boolean)
-
getPath
public String getPath()
Description copied from interface:AudioSongPath.- Specified by:
getPathin interfaceAudioSong- Returns:
- path object for
AudioSong.getLocation()or null, if a proper file object cannot be formed
-
canWrite
public boolean canWrite()
Description copied from interface:AudioSongChecks whether the file corresponding to this song can in principal be written to.
-
hasProtectedFileExtension
public boolean hasProtectedFileExtension()
Description copied from interface:AudioSongChecks file endings instead of the protected flag in the iTunes Music Library.xml, since iTunes marks non-protected versions of files that used to be protected still as protected.- Specified by:
hasProtectedFileExtensionin interfaceAudioSong- Returns:
- true, if we know that the file-format is usually protected.
-
getBeatsPerMinute
public float getBeatsPerMinute()
Description copied from interface:AudioSongBeats per minute (BPM).- Specified by:
getBeatsPerMinutein interfaceAudioSong- Returns:
- beats per minute
- See Also:
AudioSong.getTempo()
-
getTempo
public com.tagtraum.audiokern.bpm.Tempo getTempo()
Description copied from interface:AudioSongReturns tempo.
-
getTags
public Set<String> getTags()
Description copied from interface:AudioSongReturns a set of tags associated with this song. To manipulate this song's tag, please useAudioSong.setTags(java.util.Set)and don't manipulate the returned set.
-
getKey
public Key getKey()
Description copied from interface:AudioSongReturn the tonal key of this song. E.g.,MajorKey.C_MAJOR.
-
getKeyAlgorithm
public String getKeyAlgorithm()
Description copied from interface:AudioSongReturns the name of the key algorithm. May beEntered, if the key value was entered.- Specified by:
getKeyAlgorithmin interfaceAudioSong- Returns:
- key algorithm
-
getSpectrum
public com.tagtraum.audiokern.timbre.BarkSpectrum getSpectrum()
Description copied from interface:AudioSongReturns the bark spectrum.- Specified by:
getSpectrumin interfaceAudioSong- Returns:
- bark spectrum
- See Also:
AudioSong.getTempoTimbreColor()
-
getTempoColor
public Color getTempoColor()
Description copied from interface:AudioSongProjection ofAudioSong.getTempoSpectrum()to a color.- Specified by:
getTempoColorin interfaceAudioSong- Returns:
- color or null
-
getTempoTimbreColor
public Color getTempoTimbreColor()
Description copied from interface:AudioSongProjection ofAudioSong.getTempoSpectrum()andAudioSong.getSpectrum()to a color.- Specified by:
getTempoTimbreColorin interfaceAudioSong- Returns:
- color or null
-
getTempoSpectrum
public com.tagtraum.audiokern.bpm.TempoSpectrum getTempoSpectrum()
Description copied from interface:AudioSongReturns the tempo spectrum.- Specified by:
getTempoSpectrumin interfaceAudioSong- Returns:
- tempo spectrum
- See Also:
AudioSong.getTempoColor(),AudioSong.getTempoTimbreColor()
-
getBeatsPerMinuteAlgorithm
public String getBeatsPerMinuteAlgorithm()
Description copied from interface:AudioSongReturns the name of the algorithm used to determine the beats per minute (BPM).- Specified by:
getBeatsPerMinuteAlgorithmin interfaceAudioSong- Returns:
- algorithm name
-
getLanguage
public String getLanguage()
Description copied from interface:AudioSongThe language of the lyrics as ISO 639 three letter codes.- Specified by:
getLanguagein interfaceAudioSong- Returns:
- ISO 639 three letter language code
-
getFingerprint
public byte[] getFingerprint()
Description copied from interface:AudioSongAcoustic fingerprint.- Specified by:
getFingerprintin interfaceAudioSong- Returns:
- acoustic fingerprint
-
getMoodKeywords
public Set<String> getMoodKeywords()
Description copied from interface:AudioSongGet raw mood keywords.- Specified by:
getMoodKeywordsin interfaceAudioSong- Returns:
- mood keywords
-
getTrackIds
public Set<AudioId> getTrackIds()
Description copied from interface:AudioSongReturns track ids.- Specified by:
getTrackIdsin interfaceAudioSong- Returns:
- track ids
-
getAlbumIds
public Set<AudioId> getAlbumIds()
Description copied from interface:AudioSongGet album ids.- Specified by:
getAlbumIdsin interfaceAudioSong- Returns:
- album ids
-
getArtistIds
public Set<AudioId> getArtistIds()
Description copied from interface:AudioSongGet artists ids.- Specified by:
getArtistIdsin interfaceAudioSong- Returns:
- artist ids
-
getLyrics
public String getLyrics()
Description copied from interface:AudioSongReturns the lyrics.
-
getLyricsTermFrequencies
public List<TermFrequency> getLyricsTermFrequencies()
Description copied from interface:AudioSongTerms in this song's lyrics along with their frequency. All terms are lowercase, regular ASCII punctuation has been removed.- Specified by:
getLyricsTermFrequenciesin interfaceAudioSong- Returns:
- term frequencies
-
getTuningAlgorithm
public String getTuningAlgorithm()
Description copied from interface:AudioSongThe method the current tuning was created with.- Specified by:
getTuningAlgorithmin interfaceAudioSong- Returns:
- tuning algorithm
-
getMeasuresPerMinute
public float getMeasuresPerMinute()
Description copied from interface:AudioSongMeasures (bars) per minute. This value is computed fromAudioSong.getBeatsPerMinute()andAudioSong.getTimeSignature(). In essence BPM is divided by meter (time signature) numerator.- Specified by:
getMeasuresPerMinutein interfaceAudioSong- Returns:
- measures/bars per minute or zero, if either the time signature or the BPM is not known
-
getDanceability
public Float getDanceability()
Description copied from interface:AudioSongDanceability.- Specified by:
getDanceabilityin interfaceAudioSong- Returns:
- normalized positive value (0-1)
-
getDanceabilityAlgorithm
public String getDanceabilityAlgorithm()
Description copied from interface:AudioSongReturns the name of the danceability algorithm. May beEntered, if the value was entered.- Specified by:
getDanceabilityAlgorithmin interfaceAudioSong- Returns:
- danceability algorithm
-
getInstrumentation
public AudioSong.Instrumentation getInstrumentation()
Description copied from interface:AudioSongIndicates whether this song qualifies as "electronic" or "acoustic".- Specified by:
getInstrumentationin interfaceAudioSong- Returns:
- instrumentation
-
getInstrumentationAlgorithm
public String getInstrumentationAlgorithm()
Description copied from interface:AudioSongReturns the name of the instrumentation algorithm. May beEntered, if the value was entered.- Specified by:
getInstrumentationAlgorithmin interfaceAudioSong- Returns:
- instrumentation algorithm
-
getMoodAlgorithm
public String getMoodAlgorithm()
Description copied from interface:AudioSongThe method the associated mood value was created with.- Specified by:
getMoodAlgorithmin interfaceAudioSong- Returns:
- mood algorithm
-
getTimeSignature
public TimeSignature getTimeSignature()
Description copied from interface:AudioSongThe song's time signature.- Specified by:
getTimeSignaturein interfaceAudioSong- Returns:
- time signature
-
getTimeSignatureAlgorithm
public String getTimeSignatureAlgorithm()
Description copied from interface:AudioSongMethod the time signature was computed with.- Specified by:
getTimeSignatureAlgorithmin interfaceAudioSong- Returns:
- algorithm the time signature was computed with
-
getBeatsAlgorithm
public String getBeatsAlgorithm()
Description copied from interface:AudioSongMethod the beats were computed with.- Specified by:
getBeatsAlgorithmin interfaceAudioSong- Returns:
- algorithm the beats were computed with
-
getSegments
public Segments getSegments()
Description copied from interface:AudioSongThe song's segments.- Specified by:
getSegmentsin interfaceAudioSong- Returns:
- segments
-
getSegmentsAlgorithm
public String getSegmentsAlgorithm()
Description copied from interface:AudioSongMethod the segments were computed with.- Specified by:
getSegmentsAlgorithmin interfaceAudioSong- Returns:
- algorithm the segments were computed with
-
getSimilarities
public Similarities getSimilarities()
Description copied from interface:AudioSongThe song's similarities.- Specified by:
getSimilaritiesin interfaceAudioSong- Returns:
- similarities
-
getSimilaritiesAlgorithm
public String getSimilaritiesAlgorithm()
Description copied from interface:AudioSongMethod the similarities were computed with.- Specified by:
getSimilaritiesAlgorithmin interfaceAudioSong- Returns:
- algorithm the similarities were computed with
-
getLoudness
public Loudness getLoudness()
Description copied from interface:AudioSongThe song's loudness curve.- Specified by:
getLoudnessin interfaceAudioSong- Returns:
- loudness
-
getRMSMean
public Float getRMSMean()
Description copied from interface:AudioSongRoot mean square (RMS) of the signal's energy, averaged over windows of length ~23ms (actually 1024/44100 frames for a signal with sample rate 44.1kHz, i.e. 23.22ms) with a hopsize of half a window. Only the first 120 seconds of the audio are considered, the rest is discarded.- Specified by:
getRMSMeanin interfaceAudioSong- Returns:
- average RMS for the first 120 seconds
- See Also:
TemporalFeaturePipelines.createAverageRootMeanSquarePipeline(String, int, int),Floats.rootMeanSquare(float[]),AudioSong.getRMSStandardDeviation()
-
getRMSStandardDeviation
public Float getRMSStandardDeviation()
Description copied from interface:AudioSongStandard deviation of the root mean square energy values for windows of length ~23ms (actually 1024/44100 frames for a signal with sample rate 44.1kHz) with a hopsize of half a window. Only the first 120 seconds of the audio are considered, the rest is discarded.- Specified by:
getRMSStandardDeviationin interfaceAudioSong- Returns:
- standard deviation of the RMS for the first 120 seconds
- See Also:
Floats.rootMeanSquare(float[]),AudioSong.getRMSMean()
-
getSpectralCentroidMean
public Float getSpectralCentroidMean()
Description copied from interface:AudioSongAverage of the spectral centroids computed for individual windows of length ~23.22ms with a hopsize of half a window length. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getSpectralCentroidMeanin interfaceAudioSong- Returns:
- averaged spectral centroid
- See Also:
SpectralFeaturePipelines.createAverageSpectralCentroidPipeline(String, int, int, int)
-
getSpectralSpreadMean
public Float getSpectralSpreadMean()
Description copied from interface:AudioSongAverage of the spectral spread values computed for windows of length 23.22ms, with a hopsize of half a window. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getSpectralSpreadMeanin interfaceAudioSong- Returns:
- average spectral spread
- See Also:
SpectralFeaturePipelines.createAverageSpectralSpreadPipeline(String, int, int, int)
-
getRelativeSpectralEntropyMean
public Float getRelativeSpectralEntropyMean()
Description copied from interface:AudioSongAverage of relative entropy values computed for windows of length 1.486s with a hopsize of half a window. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getRelativeSpectralEntropyMeanin interfaceAudioSong- Returns:
- average relative entropy
- See Also:
AggregateFunctions.RELATIVE_ENTROPY,SpectralFeaturePipelines.createAverageRelativeSpectralEntropyPipeline(String, int, int, int)
-
getSpectralNoveltyMean
public Float getSpectralNoveltyMean()
Description copied from interface:AudioSongAverage of the spectral novelty values computed for windows of length 23.22ms, with a hopsize of half a window. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getSpectralNoveltyMeanin interfaceAudioSong- Returns:
- average spectral novelty
-
getSpectralFluctuationPeak
public Float getSpectralFluctuationPeak()
Description copied from interface:AudioSongPeak of the averaged spectral fluctuation values computed for windows of length 23.22ms, with a hopsize of half a window. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getSpectralFluctuationPeakin interfaceAudioSong- Returns:
- peak of an averaged fluctuation spectrum
- See Also:
SpectralFeaturePipelines.createAverageSpectralFluctuationPipeline(String, int)
-
getSpectralFluxMean
public Float getSpectralFluxMean()
Description copied from interface:AudioSongAverage of the spectral flux values computed for windows of length 23.22ms, with a hopsize of half a window. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getSpectralFluxMeanin interfaceAudioSong- Returns:
- average spectral flux
- See Also:
SpectralFeaturePipelines.createAverageSpectralFluxPipeline(String, int, int, int)
-
getSpectralVariabilityMean
public Float getSpectralVariabilityMean()
Description copied from interface:AudioSongAverage of the spectral variability values computed for windows of length 23.22ms, with a hopsize of half a window. Only the first 120 seconds of the signal are considered, the rest is discarded.- Specified by:
getSpectralVariabilityMeanin interfaceAudioSong- Returns:
- average spectral variability
- See Also:
SpectralFeaturePipelines.createAverageSpectralVariabilityPipeline(String, int, int, int)
-
getFrontCoverImage
public Image getFrontCoverImage()
Description copied from interface:AudioSongReturns the first front cover image.- Specified by:
getFrontCoverImagein interfaceAudioSong- Returns:
- image or null
-
getBackCoverImage
public Image getBackCoverImage()
Description copied from interface:AudioSongReturns the first front cover image.- Specified by:
getBackCoverImagein interfaceAudioSong- Returns:
- image or null
-
getArtworks
public AudioArtwork[] getArtworks()
Description copied from interface:AudioSongArtwork belonging to this song.- Specified by:
getArtworksin interfaceAudioSong- Returns:
- array of artworks
-
-