Utilities to be used in scripts. Access via the global app.utils.

Hierarchy

  • Utils

Constructors

Properties

Methods

addCachedThumbPath addToPlayedAsync assignGroupData2ListAsync bitRateToStr boolToYesNo burnAudioCDTracksAsync canFileStoreImages checkFormatAvailability clearThumbPathsCache convertProcessorsCount copyToClipboard createAlbumlist createArtistlist createEmptyAlbum createEmptyArtist createEmptyGenre createEmptyList createEmptyTrack createSharedList createTrackGroupData createTracklist createUUID dateTime2Timestamp dateTimeToStr dialogOpenFile dialogSaveFile droppingFolder ejectDriveAsync fixFilenames formatNormalization formatTimestamp freqToStr getApplicationVersion getAudioCDInfoAsync getAudioCDTracksAsync getBurnDriveListAsync getConst getCoverTypes getDataFromClipboard getDate getDateNow getDateNowInt getDateNow_UTC getDirectory getDragFileMIME getDroppedFiles getDuplicates getFilename getGoldInfo getJustInstalled getLingBase getMainMonitorInfo getMaxPathLength getMetadataInfoFromTracksAsync getMonitorInfoFromCoords getNormalizeText getNumberOfTracksUsingCoverAsync getPortableMode getSampleTrack getSampleTrackAsync getTaskbarColor getTaskbarPosition getTempFilePathAsync getTypeStringId getTypeText getUNCPath getUsedLanguage getUserName getValueLink isAbsolutePath isAccessibleMediaAsync isRegistered language2shortcut lingCompare logStackTrace md5HexaHash modifyFilenamesExtAsync multiString2VisualString myDecodeDate myEncodeDate myFormatDateTime normalizeAlbumName openExplorerFolder prepareImage registerApp registerLink registeredName removeCoversIfLast removeFilenameExtension resolveDropFiles resolveDropFolders resolveDropImage saveImageAsync shellExecute showCursor showTaskBar showTrialExpiredDialog showVirtualKeyboard songTimeToStr songTimeToStrEx stereoToStr strToSongTimeEx string2BPM stringSimilarity system text2TrackType timestamp2DateTime visualString2MultiString

Constructors

Properties

web: Web

Returns web utils class

Methods

  • Undocumented

    Parameters

    Returns void

  • Undocumented

    Parameters

    Returns Promise<any>

  • Undocumented

    Parameters

    • groupData: Track
    • alist: Tracklist
    • withSave: boolean
    • tagModified: boolean
    • applyArtworkToAlbum: boolean

    Returns Promise<any>

  • Undocumented

    Parameters

    • BR: number

    Returns string

  • Undocumented

    Parameters

    • i: boolean

    Returns string

  • Undocumented

    Parameters

    Returns Promise<any>

  • Undocumented

    Parameters

    • fname: string

    Returns boolean

  • Undocumented

    Parameters

    Returns Promise<any>

  • Undocumented

    Returns void

  • Undocumented

    Parameters

    • count: number

    Returns number

  • Copy objects to clipboard.

    Parameters

    • data: SharedObject

      Objects to copy, typically SongList.

    • Optional params: {
          cut?: boolean;
          srcObject?: any;
      }

      Object with additional static (serializable) data

      • Optional cut?: boolean

        Undocumented

      • Optional srcObject?: any

        Undocumented

    Returns Promise<any>

  • Creates new AlbumList interface to be used as list of albums.

    Parameters

    • Optional loaded: boolean

      set as loaded

    Returns AlbumList

  • Creates new ArtistList interface to be used as list of albums.

    Parameters

    • Optional loaded: boolean

    Returns ArtistList

  • Creates empty album data, useful for storing temporary data etc.

    Returns Album

    album

  • Creates empty artist data, useful for storing temporary data etc.

    Returns Artist

    artist

  • Creates empty genre data, useful for storing temporary data etc.

    Returns Genre

    genre

  • Creates empty object list. Unlike createSharedList it supports searching/filtering. isLoaded needs to be properly set to true (once the list is filled) so that searching/filtering works!

    Returns SharedUIList<SharedObservable>

  • Creates empty track data, useful for storing temporary data etc.

    Returns Track

    track

  • Creates empty shared object list, is similar to createEmptyList, but does not support auto-update and searching/filtering

    Returns SharedList<SharedObject>

  • Undocumented

    Returns Track

  • Creates new Tracklist interface to be used as list of tracks.

    Parameters

    • Optional loaded: boolean

      set as loaded

    Returns Tracklist

  • Undocumented

    Returns string

  • Converts dateTime to timestamp format 'YYYY-MM-DD HH:MM:SS'

    Parameters

    • val: number

    Returns string

  • Undocumented

    Parameters

    • dt: number

    Returns string

  • Opens system's open file dialog

    Parameters

    • initialDir: string
    • defaultExt: string
    • filter: string
    • title: string
    • Optional allowMultiSelect: boolean

    Returns Promise<any>

  • Opens system's save file dialog

    Parameters

    • initialDir: string
    • defaultExt: string
    • filter: string
    • title: string
    • Optional defaultFilename: string

    Returns Promise<any>

  • Undocumented

    Returns boolean

  • Ejects media of the removable drive
    Introduced in version 5.0.4

    Parameters

    • Letter: string

      drive letter of the drive to eject media

    Returns Promise<any>

  • This function auto-resolves duplicate and overly long filenames, adds numbered suffix for dups and shortened long paths

    Parameters

    • namesToFix: StringList

      List of finenames to fix

    • checkedState: SharedList<Base>

      List with check states (only checked item will be taken into account)

    • cutLongPath: boolean

      Whether the paths should be shortened to 260 chars

    Returns void

  • Undocumented

    Parameters

    • NormalizeValue: number

    Returns string

  • Returns pretty print local date time

    Parameters

    • timestamp: string

      in UTC form 'YYYY-MM-DD HH:MM:SS'

    Returns string

  • Undocumented

    Parameters

    • i: number

    Returns string

  • Get the application version, with the specified level of detail.

    Example

    app.utils.getApplicationVersion(1); // returns "5"
    app.utils.getApplicationVersion(2); // returns "5.0"
    app.utils.getApplicationVersion(3); // returns "5.0.2"
    app.utils.getApplicationVersion(4); // returns "5.0.2.2532"

    Parameters

    • levels: number

      Level of detail, i.e. return major.minor, major.minor.release, etc. Accepts integers 1 through 4.

    Returns string

    Version number with the requested level of detail.

  • Gets audio CD album/tracks information from Freedb

    Parameters

    • Letter: string

      drive letter of the CD drive (use empty string to search all audio CD/DVD/BD drives)

    Returns Promise<any>

  • Gets tracks from audio CD

    Parameters

    • Letter: string

      Drive letter of the CD drive (use empty string to search all audio CD/DVD/BD drives)

    Returns Promise<any>

  • Undocumented

    Returns Promise<any>

  • Undocumented

    Parameters

    • id: string

    Returns string

  • Returns object with data from clipboard.

    Parameters

    • Optional justTest: boolean

      Since bitmaps take a long time to retrieve from the clipboard, if true, the data will just be "bitmap" in the case where an image was copied to the clipboard.

    Returns ClipboardDataReturn

  • Undocumented

    Parameters

    • val: number

    Returns any

  • Undocumented

    Returns number

  • Undocumented

    Returns number

  • Undocumented

    Returns number

  • Undocumented

    Parameters

    • path: string

    Returns string

  • Undocumented

    Parameters

    • index: number

    Returns string

  • This function compares strings in list and return new list with duplicated strings (each duplicate is represented once in returned list).

    Parameters

    Returns StringList

  • Undocumented

    Parameters

    • path: string

    Returns string

  • Undocumented

    Returns string

  • Undocumented

    Returns boolean

  • Get lingual base of the string field (useful when comparing/matching song metadata) Examples: 'I am Believer - 2006 Remaster' ==> 'I am Believer' 'More of The Monkees (Deluxe Edition)' ==> 'More of The Monkees' 'A New Machine (Pt. 1) - 2019' ==> 'New Machine' 'I Want You Back - Radio Edit') ==> 'I Want You Back' 'Rock with You - Single Version' ==> 'Rock with You'

    Parameters

    • str: string

      text string to process

    Returns string

  • Undocumented

    Returns any

  • Undocumented

    Returns number

  • Undocumented

    Parameters

    Returns Promise<any>

  • Undocumented

    Parameters

    • Rest ...params: any[]

    Returns any

  • Undocumented

    Parameters

    • NormalizeTrack: number
    • NormalizeAlbum: number

    Returns string

  • Undocumented

    Parameters

    • imagepath: string

    Returns Promise<any>

  • Retrieve true when app is in portable mode.

    Returns boolean

  • Undocumented

    Parameters

    • trackType: string

    Returns Track

  • Gets a random track fullfilling the given type

    Parameters

    • trackType: string

      (can be: music, video, musicvideo, classical, audiobook, podcast, videopodcast, tv)

    Returns Promise<any>

    track

  • Undocumented

    Returns any

  • Undocumented

    Returns any

  • Gets temporary file path in the temp directory and returns as param of the promise's resolve func

    Returns Promise<any>

  • Undocumented

    Parameters

    • i: number

    Returns string

  • Undocumented

    Parameters

    • i: number

    Returns string

  • Undocumented

    Parameters

    • path: string

    Returns Promise<any>

  • Undocumented

    Returns string

  • Undocumented

    Returns string

  • Checks whether path is absolute (e.g. C:\...)

    Parameters

    • path: string

    Returns boolean

  • Undocumented

    Parameters

    • idMedia: number

    Returns Promise<any>

  • Return true if app is licensed.

    Returns boolean

  • Undocumented

    Parameters

    • lang: string

    Returns string

  • Linguist compare of two strings e.g. 'a-ha' matches ' aha' 'Vague / E La Nave Va' matches 'Vàgue/E la Nave Va'

    Parameters

    • str1: string

      string 1 to compare

    • str2: string

      string 2 to compare

    • ignoreBrackets: boolean

      if TRUE then ignores the appendixes in brackets -- like ...(remastered)

    Returns boolean

  • Undocumented

    Returns string

  • Returns 32-character hexadecimal md5 hash of given string. String is converted to UTF8 before hashing

    Parameters

    • s: string

      string to hash

    • Optional secretId: string

      secret key id, which is appended before hash

    Returns string

  • Undocumented

    Parameters

    Returns Promise<any>

  • Undocumented

    Parameters

    • s: string

    Returns string

  • Converts text date representation to integer.

    Parameters

    • text: string

      String date value

    Returns number

  • Converts integer date representation to string.

    Parameters

    • val: number

      Integer date value

    Returns string

  • Undocumented

    Parameters

    • val: number

    Returns string

  • Undocumented

    Parameters

    • name: string

    Returns string

  • Opens folder in file explorer (e.g. Windows explorer on Windows)

    Parameters

    • path: string

      Path to open

    Returns Promise<any>

  • Undocumented

    Parameters

    • url: string
    • maxWidth: number
    • maxHeight: number
    • callback: any

    Returns void

  • Undocumented

    Parameters

    • username: string
    • licenseKey: string

    Returns Promise<any>

  • Undocumented

    Returns string

  • Undocumented

    Returns string

  • Undocumented

    Parameters

    • arr: any

    Returns void

  • Undocumented

    Parameters

    • path: string

    Returns string

  • Undocumented

    Returns Promise<any>

  • Undocumented

    Returns Promise<any>

  • Undocumented

    Parameters

    • Rest ...params: any[]

    Returns Promise<any>

  • Undocumented

    Parameters

    • imageLink: string

    Returns Promise<any>

  • Undocumented

    Parameters

    • show: boolean

    Returns void

  • Show/hide system taskbar (Windows only). Used mainly for fullscreen video.

    Parameters

    • showIt: boolean

      Boolean value to show (true) or hide (false) system taskbar.

    Returns void

  • Undocumented

    Parameters

    • plugTitle: string
    • missingCodecConst: string

    Returns Promise<any>

  • Undocumented

    Returns void

  • Undocumented

    Parameters

    • time: number

    Returns string

  • Undocumented

    Parameters

    • time: number

    Returns string

  • Undocumented

    Parameters

    • i: number

    Returns string

  • Undocumented

    Parameters

    • str: string

    Returns number

  • Undocumented

    Parameters

    • ws: string

    Returns number

  • Undocumented

    Parameters

    • s1: string
    • s2: string
    • caseSensitive: boolean

    Returns number

  • Undocumented

    Returns string

  • Undocumented

    Parameters

    • Text: string

    Returns number

  • Converts timestamp format 'YYYY-MM-DD HH:MM:SS' to dateTime accepts also ISO 8601 form YYYY-MM-DDTHH:mm:ss.sssZ

    Parameters

    • val: string

      Timestamp in UTC form 'YYYY-MM-DD HH:MM:SS'

    Returns number

  • Undocumented

    Parameters

    • s: string

    Returns string