fexofenadine / powershell-taglib

A PowerShell module for manipulating metadata in media files with TagLibSharp

powershell-taglib

A PowerShell module for manipulating metadata in media files with TagLibSharp

• Installation
• Functions
• License

Installation

1. Clone this repo to your PSModulePath (typically $Env:UserProfile\Documents\WindowsPowerShell\Modules)

       C:\cd cd $Env:PSModulePath.split(';')[0]
       C:\Users\illearth\Documents\WindowsPowerShell\Modules>git clone [e-mail]:illearth/powershell-taglib.git taglib

2. Import-Module taglib

Functions

• set-artist
• set-title
• set-album
• set-track
• set-disc
• update-trackAndDisc

set-artist

Type: Filter

Parameter [string]: value to set as the artist

Description: Sets the ID tag artist

Example:

   C:\mp3\Fugazi\13 Songs> get-childitem *.mp3 | set-artist "Fugazi"

set-title

Type: Filter

Parameter [string]: Optional value to set as the title. If not passed the name of the file (less the extension) will be used (e.g. if the file is named "Waiting Room.mp3" then the title would be set at "Waiting Room")

Description: Sets the ID tag title

Example:

    C:\mp3\Fugazi\13 Songs> get-childitem WaitingRoom.mp3 | set-title "Waiting Room"

set-album

Type: Filter

Parameter [string]: value to set as the album

Description: Sets the ID tag album

Example:

    C:\mp3\Fugazi\13 Songs> get-childitem *.mp3 | set-album "13 Songs"

set-track

Type: Filter

Parameter [int]: value to set as the track

Description: Sets the ID tag track, or the track number on the album

Example:

    C:\mp3\Fugazi\13 Songs> get-childitem WaitingRoom.mp3 | set-track 1

set-disc

Type: Filter

Parameter [int]: value to set as the disc

Description: Sets the ID tag disc, or the disc number for multi-disc sets

Example:

    C:\mp3\Fugazi\13 Songs> get-childitem *.mp3 | set-disc 1

update-trackAndDisc

Type: Filter

Parameter [string]: Optional regular expression to use to match the disc and track from the title. Defaults to "D(?[0-9]+)T(?[0-9]+)" which will match the disc and track from a pattern of DXXTXX. Disc and track need to be named expression groups.

Description: Sets the disc and track of a files from a mulit-disc set by extracting the disc and track from the filename. Useful for audio book sets where you have multiple discs of a single book in a single directory.

Example:

    C:\mp3\George R. R. Martin\A Clash of Kings> get-childitem *.mp3 | update-trackAndDisc

License

Distributed under the MIT License