VLC Song Tracker is a extension that will help keep track of which songs were played in VLC.

The information of each song will be saved to a CSV ("Comma Separated Values") file with the following data. The date and time in which the song was played as well as the song information including Title, Artist, Album, Genre, Comments, and the location in which it was played at. The location can be a url for internet radio or the file where it was played from. The CSV will will be able to be parsed by most applications. One example of parsing is a spreadsheet application (LibreOffice Calc).

Installation Instructions:
Place this file in the corresponding folder(Create the folder if it does not exist) and restart VLC or reload plugin extensions.
To enable VLC Song Tracker click on View -> "VLC Song Tracker" under the menu bar.

  • Current User: ~/.local/share/vlc/lua/extensions/

  • All Users: /usr/lib/vlc/lua/extensions/

  • Windows:
  • Current User: %APPDATA%vlcluaextensions

  • All Users: %ProgramFiles%VideoLANVLCluaextensions

  • Mac OS X:
  • Current User: /Users/%your_name%/Library/Application Support/org.videolan.vlc/lua/extensions/

  • All Users: /Applications/

  • Song List Location
    The SongList.csv will be saved in the vlc user director which can be found in the following places
  • Linux: ~/.local/share/vlc/SongList.csv

  • Windows: %APPDATA%vlcSongList.csv

  • Mac OS X: /Users/%your_name%/Library/Application Support/org.videolan.vlc/SongList.csv

  • Changelog:

    0.1.4 14 hours ago

    Added duplication check to prevent writing same song in a row. Suggested by lcluster

    1 year ago

    Bug fix for description tag

    Added OS Detection to check if a specific OS and change the file location based on the OS.
    Cleaned up Debug Output

    Bug Fix for description tag

    Initial Release

    16 hours ago


    Thank you for writing this. This is the first vlc extension I have looked at and I am not a lua coder - I did notice that whatever is triggering the writing out of a csv row can happen many times for the same media item playing - fast forwarding etc.. all trigger a write. I made a slight change to the code to suit my needs that I added a couple of global variables LocationNow "" and LocationLast "" so I can write out 1 row per media item. My code is probably pretty bad but now I get 1 row per item played. I certainly could not have gotten this to work without all of the work you did on this. Thanks again. It is perfect for my needs.

    -- uri information
    local uri = item:uri()

    LocationNow = uri

    local info = date .. CSV_FS .. time .. CSV_FS .. title .. CSV_FS .. artist .. CSV_FS .. album .. CSV_FS .. genre .. CSV_FS .. description .. CSV_FS .. uri

    if LocationLast ~= LocationNow then
    LocationLast = LocationNow


    14 hours ago


    Thank you for the comment. I am thrilled that my code was able to help you out. Also that is a great idea for your changes to eliminate duplicate songs from playing. One thing I would recommend is using the value from "title" instead of "uri". The reason is that "uri" usually does not change on a radio station so if you want to only write new songs you should compare the title of the songs if they are unique unless use a combination of title, artist, album, etc. Hope that will help.


    2 months ago


    Hey, Thanks for this

    Was my first time using a plugin with VLC and just wanted to say that you might want to add that you have to do the following as well as I thought it wasn't working at first...

    also the lua and the extensions folder within lua didn't exist for me but just created them.

    But yea thanks none the less.
    To use this extension, open VLC Player and go to View Menu in Menu Bar and select 'Info Crawler'


    2 months ago


    ahh this grr... To use this extension, open VLC Player and go to View Menu in Menu Bar and select 'Info Crawler'


    2 months ago


    Thank you for the reply, feedback is much appreciated.

    Also 'Info Crawler'? Do you mean 'VLC Song Tracker' or ment to comment on the Info Crawler page?



    Recent Donations

    Be the first to donate
    Filename Version Description Filetype Packagetype License Downloads Date Filesize Install
    Score 52%
    48 Dislikes

    0 Supporters for VLC Song Tracker:

    Recent Donations:

    Be the first to donate
    show all
    updated 14 hours ago
    added Jan 23 2016
    page views 4898
    support Reiuiji
    For The Product
    VLC Song Tracker
    5 - 10 - 25 - 50 - 100 - 200 - 500