#include <libmythmetadata/musicfilescanner.h>

Collaboration diagram for MusicFileScanner:

Classes
struct	MusicFileData

Public Member Functions
	MusicFileScanner (bool force=false)

	~MusicFileScanner (void)=default

void	SearchDirs (const QStringList &dirList)
	Scan a list of directories recursively for music and albumart. Inserts, updates and removes any files any files found in the database. More...

Static Public Member Functions
static bool	IsRunning (void)

Private Types
enum	MusicFileLocation : std::uint8_t { kFileSystem , kNeedUpdate , kBoth }

using	MusicLoadedMap = QMap< QString, MusicFileData >

Private Member Functions
void	BuildFileList (QString &directory, MusicLoadedMap &music_files, MusicLoadedMap &art_files, int parentid)
	Builds a list of all the files found descending recursively into the given directory. More...

void	AddMusicToDB (const QString &filename, const QString &startDir)
	Insert music file details into database. Read the metadata and insert that information at the same time. More...

void	AddArtworkToDB (const QString &filename, const QString &startDir)
	Insert artwork file details into database. More...

void	RemoveMusicFromDB (int songid)
	Removes a music file from the database. More...

void	RemoveArtworkFromDB (int albumartid)
	Removes an artwork file from the database. More...

void	UpdateMusicInDB (const QString &filename, const QString &startDir)
	Updates a music file in the database. More...

void	ScanMusic (MusicLoadedMap &music_files, QList< int > &songidsToDelete)
	Check a list of files against music files already in the database. More...

void	ScanArtwork (MusicLoadedMap &art_files, QList< int > &albumartidsToDelete)
	Check a list of files against images already in the database. More...

Static Private Member Functions
static int	GetDirectoryId (const QString &directory, int parentid)
	Get an ID for the given directory from the database. If it doesn't already exist in the database, insert it. More...

static bool	HasFileChanged (const QString &filename, const QString &date_modified)
	Check if file has been modified since given date/time. More...

static void	cleanDB ()
	Clear orphaned entries from the genre, artist, album and albumart tables. More...

static bool	IsArtFile (const QString &filename)

static bool	IsMusicFile (const QString &filename)

static void	updateLastRunEnd (void)

static void	updateLastRunStart (void)

static void	updateLastRunStatus (QString &status)

Private Attributes
QStringList	m_startDirs

IdCache	m_directoryid

IdCache	m_artistid

IdCache	m_genreid

IdCache	m_albumid

uint	m_tracksTotal {0}

uint	m_tracksUnchanged {0}

uint	m_tracksAdded {0}

uint	m_tracksRemoved {0}

uint	m_tracksUpdated {0}

uint	m_coverartTotal {0}

uint	m_coverartUnchanged {0}

uint	m_coverartAdded {0}

uint	m_coverartRemoved {0}

uint	m_coverartUpdated {0}

bool	m_forceupdate {false}

Detailed Description

Definition at line 12 of file musicfilescanner.h.

Member Typedef Documentation

◆ MusicLoadedMap

using MusicFileScanner::MusicLoadedMap = QMap <QString, MusicFileData>

private

Definition at line 29 of file musicfilescanner.h.

Member Enumeration Documentation

◆ MusicFileLocation

enum MusicFileScanner::MusicFileLocation : std::uint8_t

private

Enumerator
kFileSystem
kNeedUpdate
kBoth

Definition at line 16 of file musicfilescanner.h.

Constructor & Destructor Documentation

◆ MusicFileScanner()

MusicFileScanner::MusicFileScanner ( bool force = false )

explicit

Definition at line 16 of file musicfilescanner.cpp.

◆ ~MusicFileScanner()

MusicFileScanner::~MusicFileScanner ( void )

default

Member Function Documentation

◆ AddArtworkToDB()

void MusicFileScanner::AddArtworkToDB	(	const QString &	filename,
		const QString &	startDir
	)

private

Insert artwork file details into database.

Parameters

filename	Full path to file.
startDir	The starting directory for the search. This will be removed making the stored name relative to the storage directory where it was found.

Returns: Nothing.

Definition at line 334 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ AddMusicToDB()

void MusicFileScanner::AddMusicToDB	(	const QString &	filename,
		const QString &	startDir
	)

private

Insert music file details into database. Read the metadata and insert that information at the same time.

Parameters

filename	Full path to file.
startDir	The starting directory for the search. This will be removed making the stored name relative to the storage directory where it was found.

Returns: Nothing.

Definition at line 246 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ BuildFileList()

void MusicFileScanner::BuildFileList	(	QString &	directory,
		MusicLoadedMap &	music_files,
		MusicLoadedMap &	art_files,
		int	parentid
	)

private

Builds a list of all the files found descending recursively into the given directory.

Parameters

directory	Directory to begin search
music_files	A pointer to the MusicLoadedMap to store the results
art_files	A pointer to the MusicLoadedMap to store the results
parentid	The id of the parent directory in the music_directories table. The root directory should have an id of 0

Returns: Nothing.

Definition at line 73 of file musicfilescanner.cpp.

Referenced by BuildFileList(), and SearchDirs().

◆ cleanDB()

void MusicFileScanner::cleanDB ( )

staticprivate

Clear orphaned entries from the genre, artist, album and albumart tables.

Returns: Nothing.

Definition at line 366 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ GetDirectoryId()

int MusicFileScanner::GetDirectoryId	(	const QString &	directory,
		int	parentid
	)

staticprivate

Get an ID for the given directory from the database. If it doesn't already exist in the database, insert it.

Parameters

directory	Relative path to directory, from base dir
parentid	The id of the parent directory in the music_directories table. The root directory should have an id of 0

Returns: Directory id

Definition at line 173 of file musicfilescanner.cpp.

Referenced by BuildFileList().

◆ HasFileChanged()

bool MusicFileScanner::HasFileChanged	(	const QString &	filename,
		const QString &	date_modified
	)

staticprivate

Check if file has been modified since given date/time.

Parameters

filename	File to examine
date_modified	Date to use in comparison

Returns: True if file has been modified, otherwise false

Definition at line 220 of file musicfilescanner.cpp.

Referenced by ScanMusic().

◆ IsArtFile()

bool MusicFileScanner::IsArtFile ( const QString & filename )

staticprivate

Definition at line 144 of file musicfilescanner.cpp.

Referenced by BuildFileList().

◆ IsMusicFile()

bool MusicFileScanner::IsMusicFile ( const QString & filename )

staticprivate

Definition at line 154 of file musicfilescanner.cpp.

Referenced by BuildFileList().

◆ IsRunning()

bool MusicFileScanner::IsRunning ( void )

static

Definition at line 907 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ RemoveArtworkFromDB()

void MusicFileScanner::RemoveArtworkFromDB ( int albumartid )

private

Removes an artwork file from the database.

Parameters

albumartid The albumart_id of the row to delete.

Returns: Nothing.

Definition at line 536 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ RemoveMusicFromDB()

void MusicFileScanner::RemoveMusicFromDB ( int songid )

private

Removes a music file from the database.

Parameters

songid The song_id of the row to delete.

Returns: Nothing.

Definition at line 518 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ ScanArtwork()

void MusicFileScanner::ScanArtwork	(	MusicLoadedMap &	art_files,
		QList< int > &	albumartidsToDelete
	)

private

Check a list of files against images already in the database.

Parameters

art_files	MusicLoadedMap
albumartidsToDelete	List of albumart_ids in the database that are not present in art_files

Returns: Nothing.

Definition at line 850 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ ScanMusic()

void MusicFileScanner::ScanMusic	(	MusicLoadedMap &	music_files,
		QList< int > &	songidsToDelete
	)

private

Check a list of files against music files already in the database.

Parameters

music_files	MusicLoadedMap
songidsToDelete	List of song_ids in the database that are not present in music_files

Returns: Nothing.

Definition at line 787 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ SearchDirs()

void MusicFileScanner::SearchDirs ( const QStringList & dirList )

Scan a list of directories recursively for music and albumart. Inserts, updates and removes any files any files found in the database.

Parameters

dirList List of directories to scan

Returns: Nothing.

Definition at line 646 of file musicfilescanner.cpp.

◆ updateLastRunEnd()

void MusicFileScanner::updateLastRunEnd ( void )

staticprivate

Definition at line 912 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ updateLastRunStart()

void MusicFileScanner::updateLastRunStart ( void )

staticprivate

Definition at line 918 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ updateLastRunStatus()

void MusicFileScanner::updateLastRunStatus ( QString & status )

staticprivate

Definition at line 924 of file musicfilescanner.cpp.

Referenced by SearchDirs().

◆ UpdateMusicInDB()

void MusicFileScanner::UpdateMusicInDB	(	const QString &	filename,
		const QString &	startDir
	)

private

Updates a music file in the database.

Parameters

filename	Full path to file.
startDir	The starting directory for the search. This will be removed making the stored name relative to the storage directory where it was found.

Returns: Nothing.

Definition at line 557 of file musicfilescanner.cpp.

Referenced by SearchDirs().

Member Data Documentation

◆ m_albumid

IdCache MusicFileScanner::m_albumid

private

Definition at line 61 of file musicfilescanner.h.

Referenced by AddMusicToDB(), MusicFileScanner(), and UpdateMusicInDB().

◆ m_artistid

IdCache MusicFileScanner::m_artistid

private

Definition at line 59 of file musicfilescanner.h.

Referenced by AddMusicToDB(), MusicFileScanner(), and UpdateMusicInDB().

◆ m_coverartAdded

uint MusicFileScanner::m_coverartAdded {0}

private

Definition at line 70 of file musicfilescanner.h.

Referenced by AddArtworkToDB(), and SearchDirs().

◆ m_coverartRemoved

uint MusicFileScanner::m_coverartRemoved {0}

private

Definition at line 71 of file musicfilescanner.h.

Referenced by RemoveArtworkFromDB(), and SearchDirs().

◆ m_coverartTotal

uint MusicFileScanner::m_coverartTotal {0}

private

Definition at line 68 of file musicfilescanner.h.

Referenced by SearchDirs().

◆ m_coverartUnchanged

uint MusicFileScanner::m_coverartUnchanged {0}

private

Definition at line 69 of file musicfilescanner.h.

Referenced by ScanArtwork(), and SearchDirs().

◆ m_coverartUpdated

uint MusicFileScanner::m_coverartUpdated {0}

private

Definition at line 72 of file musicfilescanner.h.

Referenced by SearchDirs().

◆ m_directoryid

IdCache MusicFileScanner::m_directoryid

private

Definition at line 58 of file musicfilescanner.h.

Referenced by AddArtworkToDB(), AddMusicToDB(), BuildFileList(), MusicFileScanner(), and UpdateMusicInDB().

◆ m_forceupdate

bool MusicFileScanner::m_forceupdate {false}

private

Definition at line 74 of file musicfilescanner.h.

Referenced by ScanMusic().

◆ m_genreid

IdCache MusicFileScanner::m_genreid

private

Definition at line 60 of file musicfilescanner.h.

Referenced by AddMusicToDB(), MusicFileScanner(), and UpdateMusicInDB().

◆ m_startDirs

QStringList MusicFileScanner::m_startDirs

private

Definition at line 57 of file musicfilescanner.h.

Referenced by BuildFileList(), ScanArtwork(), ScanMusic(), and SearchDirs().

◆ m_tracksAdded

uint MusicFileScanner::m_tracksAdded {0}

private

Definition at line 65 of file musicfilescanner.h.

Referenced by AddMusicToDB(), and SearchDirs().

◆ m_tracksRemoved

uint MusicFileScanner::m_tracksRemoved {0}

private

Definition at line 66 of file musicfilescanner.h.

Referenced by RemoveMusicFromDB(), and SearchDirs().

◆ m_tracksTotal

uint MusicFileScanner::m_tracksTotal {0}

private

Definition at line 63 of file musicfilescanner.h.

Referenced by SearchDirs().

◆ m_tracksUnchanged

uint MusicFileScanner::m_tracksUnchanged {0}

private

Definition at line 64 of file musicfilescanner.h.

Referenced by ScanMusic(), and SearchDirs().

◆ m_tracksUpdated

uint MusicFileScanner::m_tracksUpdated {0}

private

Definition at line 67 of file musicfilescanner.h.

Referenced by SearchDirs().

The documentation for this class was generated from the following files:

mythtv/libs/libmythmetadata/musicfilescanner.h
mythtv/libs/libmythmetadata/musicfilescanner.cpp

Classes

Public Member Functions

Static Public Member Functions

Private Types

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ MusicLoadedMap

Member Enumeration Documentation

◆ MusicFileLocation

Constructor & Destructor Documentation

◆ MusicFileScanner()

◆ ~MusicFileScanner()

Member Function Documentation

◆ AddArtworkToDB()

◆ AddMusicToDB()

◆ BuildFileList()

◆ cleanDB()

◆ GetDirectoryId()

◆ HasFileChanged()

◆ IsArtFile()

◆ IsMusicFile()

◆ IsRunning()

◆ RemoveArtworkFromDB()

◆ RemoveMusicFromDB()

◆ ScanArtwork()

◆ ScanMusic()

◆ SearchDirs()

◆ updateLastRunEnd()

◆ updateLastRunStart()

◆ updateLastRunStatus()

◆ UpdateMusicInDB()

Member Data Documentation

◆ m_albumid

◆ m_artistid

◆ m_coverartAdded

◆ m_coverartRemoved

◆ m_coverartTotal

◆ m_coverartUnchanged

◆ m_coverartUpdated

◆ m_directoryid

◆ m_forceupdate

◆ m_genreid

◆ m_startDirs

◆ m_tracksAdded

◆ m_tracksRemoved

◆ m_tracksTotal

◆ m_tracksUnchanged

◆ m_tracksUpdated