/* * Copyright (C) 2013 Emeric Poupon * * This file is part of LMS. * * LMS is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * LMS is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with LMS. If not, see . */ #include "ScannerService.hpp" #include #include #include "core/IConfig.hpp" #include "core/IJobScheduler.hpp" #include "core/ILogger.hpp" #include "core/ITraceLogger.hpp" #include "database/Session.hpp" #include "database/objects/MediaLibrary.hpp" #include "database/objects/ScanSettings.hpp" #include "scanners/ArtistInfoFileScanner.hpp" #include "scanners/AudioFileScanner.hpp" #include "scanners/ImageFileScanner.hpp" #include "scanners/LyricsFileScanner.hpp" #include "scanners/PlayListFileScanner.hpp" #include "steps/ScanStepArtistReconciliation.hpp" #include "steps/ScanStepAssociateArtistImages.hpp" #include "steps/ScanStepAssociateExternalLyrics.hpp" #include "steps/ScanStepAssociateMediumImages.hpp" #include "steps/ScanStepAssociatePlayListTracks.hpp" #include "steps/ScanStepAssociateReleaseImages.hpp" #include "steps/ScanStepAssociateTrackImages.hpp" #include "steps/ScanStepCheckForDuplicatedFiles.hpp" #include "steps/ScanStepCheckForRemovedFiles.hpp" #include "steps/ScanStepCompact.hpp" #include "steps/ScanStepComputeClusterStats.hpp" #include "steps/ScanStepOptimize.hpp" #include "steps/ScanStepRemoveOrphanedDbEntries.hpp" #include "steps/ScanStepScanFiles.hpp" #include "steps/ScanStepUpdateLibraryFields.hpp" #include "ScanContext.hpp" namespace lms::scanner { using namespace db; namespace { constexpr std::string_view currentSettingsName{}; constexpr std::string_view lastScanSettingsName{ "last_scan" }; Wt::WDate getNextMonday(Wt::WDate current) { do { current = current.addDays(1); } while (current.dayOfWeek() != 1); return current; } Wt::WDate getNextFirstOfMonth(Wt::WDate current) { do { current = current.addDays(1); } while (current.day() != 1); return current; } std::optional readScannerSettings(db::Session& session, std::string_view name) { std::optional settings; auto transaction{ session.createReadTransaction() }; const ScanSettings::pointer scanSettings{ ScanSettings::find(session, name) }; if (!scanSettings) return settings; settings.emplace(); settings->audioScanVersion = scanSettings->getAudioScanVersion(); settings->artistInfoScanVersion = scanSettings->getArtistInfoScanVersion(); settings->startTime = scanSettings->getUpdateStartTime(); settings->updatePeriod = scanSettings->getUpdatePeriod(); MediaLibrary::find(session, [&](const MediaLibrary::pointer& mediaLibrary) { MediaLibraryInfo info; info.firstScan = mediaLibrary->isEmpty(); info.id = mediaLibrary->getId(); info.rootDirectory = mediaLibrary->getPath().lexically_normal(); settings->mediaLibraries.push_back(info); }); { const auto& tags{ scanSettings->getExtraTagsToScan() }; std::transform(std::cbegin(tags), std::cend(tags), std::back_inserter(settings->extraTags), [](std::string_view tag) { return std::string{ tag }; }); } settings->artistTagDelimiters = scanSettings->getArtistTagDelimiters(); settings->defaultTagDelimiters = scanSettings->getDefaultTagDelimiters(); settings->artistsToNotSplit = scanSettings->getArtistsToNotSplit(); settings->skipSingleReleasePlayLists = scanSettings->getSkipSingleReleasePlayLists(); settings->allowArtistMBIDFallback = scanSettings->getAllowMBIDArtistMerge(); settings->artistImageFallbackToRelease = scanSettings->getArtistImageFallbackToReleaseField(); // TODO, store this in DB + expose in UI settings->skipDuplicateTrackMBID = core::Service::get()->getBool("scanner-skip-duplicate-mbid", false); return settings; } void writeScannerSettings(db::Session& session, std::string_view name, const ScannerSettings& settings) { auto transaction{ session.createWriteTransaction() }; ScanSettings::pointer scanSettings{ ScanSettings::find(session, name) }; if (!scanSettings) scanSettings = session.create(name); scanSettings.modify()->setAllowMBIDArtistMerge(settings.allowArtistMBIDFallback); scanSettings.modify()->setSkipSingleReleasePlayLists(settings.skipSingleReleasePlayLists); // TODO add more fields } std::size_t getScannerThreadCount() { std::size_t threadCount{ core::Service::get()->getULong("scanner-thread-count", 0) }; if (threadCount == 0) threadCount = std::max(std::thread::hardware_concurrency() / 2, 1); return threadCount; } } // namespace std::unique_ptr createScannerService(db::IDb& db) { return std::make_unique(db); } ScannerService::ScannerService(db::IDb& db) : _db{ db } , _jobScheduler{ core::createJobScheduler("Scanner", getScannerThreadCount()) } { _ioService.setThreadCount(1); LMS_LOG(DBUPDATER, INFO, "Using " << _jobScheduler->getThreadCount() << " thread(s) for jobs"); _jobScheduler->setShouldAbortCallback([this]() { return _abortScan; }); std::size_t totalFileCount{}; { auto& session{ _db.getTLSSession() }; auto transaction{ session.createReadTransaction() }; totalFileCount = session.getFileStats().getTotalFileCount(); } // Force optimize in case scanner aborted during a large import, but do this only if there are enough elements in the database // Otherwise, indexes may be not used and queries may be slower and slower while adding more and more elements in the db LMS_LOG(DBUPDATER, INFO, "Scanned file count = " << totalFileCount); if (totalFileCount >= 1'000) _db.getTLSSession().fullAnalyze(); refreshTracingLoggerStats(); refreshScanSettings(); start(); } ScannerService::~ScannerService() { LMS_LOG(DBUPDATER, INFO, "Stopping service..."); stop(); LMS_LOG(DBUPDATER, INFO, "Service stopped!"); } void ScannerService::start() { std::scoped_lock lock{ _controlMutex }; _ioService.post([this] { if (_abortScan) return; scheduleNextScan(); }); _ioService.start(); } void ScannerService::stop() { std::scoped_lock lock{ _controlMutex }; _abortScan = true; _scheduleTimer.cancel(); _ioService.stop(); } void ScannerService::abortScan() { bool isRunning{}; { std::scoped_lock lock{ _statusMutex }; isRunning = _curState == State::InProgress; } LMS_LOG(DBUPDATER, DEBUG, "Aborting scan..."); std::scoped_lock lock{ _controlMutex }; LMS_LOG(DBUPDATER, DEBUG, "Waiting for the scan to abort..."); _abortScan = true; _scheduleTimer.cancel(); _ioService.stop(); LMS_LOG(DBUPDATER, DEBUG, "Scan abort done!"); _abortScan = false; _ioService.start(); if (isRunning) _events.scanAborted.emit(); } void ScannerService::requestImmediateScan(const ScanOptions& scanOptions) { abortScan(); _ioService.post([this, scanOptions] { if (_abortScan) return; scheduleScan(scanOptions); }); } void ScannerService::requestReload() { abortScan(); _ioService.post([this]() { if (_abortScan) return; scheduleNextScan(); }); } ScannerService::Status ScannerService::getStatus() const { Status res; std::shared_lock lock{ _statusMutex }; res.currentState = _curState; res.nextScheduledScan = _nextScheduledScan; res.lastCompleteScanStats = _lastCompleteScanStats; res.currentScanStepStats = _currentScanStepStats; return res; } void ScannerService::scheduleNextScan() { LMS_LOG(DBUPDATER, DEBUG, "Scheduling next scan"); refreshScanSettings(); const Wt::WDateTime now{ Wt::WDateTime::currentDateTime() }; Wt::WDateTime nextScanDateTime; switch (_settings.updatePeriod) { case ScanSettings::UpdatePeriod::Daily: if (now.time() < _settings.startTime) nextScanDateTime = { now.date(), _settings.startTime }; else nextScanDateTime = { now.date().addDays(1), _settings.startTime }; break; case ScanSettings::UpdatePeriod::Weekly: if (now.time() < _settings.startTime && now.date().dayOfWeek() == 1) nextScanDateTime = { now.date(), _settings.startTime }; else nextScanDateTime = { getNextMonday(now.date()), _settings.startTime }; break; case ScanSettings::UpdatePeriod::Monthly: if (now.time() < _settings.startTime && now.date().day() == 1) nextScanDateTime = { now.date(), _settings.startTime }; else nextScanDateTime = { getNextFirstOfMonth(now.date()), _settings.startTime }; break; case ScanSettings::UpdatePeriod::Hourly: nextScanDateTime = { now.date(), now.time().addSecs(3600) }; break; case ScanSettings::UpdatePeriod::Never: LMS_LOG(DBUPDATER, INFO, "Auto scan disabled!"); break; } if (nextScanDateTime.isValid()) scheduleScan(ScanOptions{}, nextScanDateTime); { std::unique_lock lock{ _statusMutex }; _curState = nextScanDateTime.isValid() ? State::Scheduled : State::NotScheduled; _nextScheduledScan = nextScanDateTime; } _events.scanScheduled.emit(_nextScheduledScan); } void ScannerService::scheduleScan(const ScanOptions& scanOptions, const Wt::WDateTime& dateTime) { auto cb{ [this, scanOptions](boost::system::error_code ec) { if (ec) return; scan(scanOptions); } }; if (dateTime.isNull()) { LMS_LOG(DBUPDATER, INFO, "Scheduling next scan right now"); _scheduleTimer.expires_after(std::chrono::seconds{ 0 }); _scheduleTimer.async_wait(cb); } else { std::chrono::system_clock::time_point timePoint{ dateTime.toTimePoint() }; std::time_t t{ std::chrono::system_clock::to_time_t(timePoint) }; char ctimeStr[26]; LMS_LOG(DBUPDATER, INFO, "Scheduling next scan at " << std::string(::ctime_r(&t, ctimeStr))); _scheduleTimer.expires_at(timePoint); _scheduleTimer.async_wait(cb); } } void ScannerService::scan(const ScanOptions& scanOptions) { LMS_SCOPED_TRACE_OVERVIEW("Scanner", "Scan"); _events.scanStarted.emit(); { std::unique_lock lock{ _statusMutex }; _nextScheduledScan = {}; } LMS_LOG(UI, INFO, "New scan started!"); refreshScanSettings(); ScanContext scanContext; scanContext.scanOptions = scanOptions; ScanStats& stats{ scanContext.stats }; stats.startTime = Wt::WDateTime::currentDateTime(); processScanSteps(scanContext); { std::unique_lock lock{ _statusMutex }; _curState = State::NotScheduled; _currentScanStepStats.reset(); // must be sync with _curState } refreshTracingLoggerStats(); LMS_LOG(DBUPDATER, INFO, "Scan " << (_abortScan ? "aborted" : "complete") << ". Changes = " << stats.getChangesCount() << " (added = " << stats.additions << ", removed = " << stats.deletions << ", updated = " << stats.updates << ", failures = " << stats.failures << "), Not changed = " << stats.skips << ", Scanned = " << stats.scans << " (errors = " << stats.errorsCount << "), features fetched = " << stats.featuresFetched << ", duplicates = " << stats.duplicates.size()); { auto transaction{ _db.getTLSSession().createReadTransaction() }; const db::FileStats stats{ _db.getTLSSession().getFileStats() }; LMS_LOG(DBUPDATER, INFO, stats.getTotalFileCount() << " total files: " << stats.artistInfoCount << " artist info, " << stats.imageCount << " images, " << stats.playListCount << " playlists, " << stats.trackCount << " tracks, " << stats.trackLyricsCount << " lyrics"); } if (!_abortScan) { stats.stopTime = Wt::WDateTime::currentDateTime(); { std::unique_lock lock{ _statusMutex }; _lastCompleteScanStats = stats; } // save current settings as last scan settings to compare during next scans if something changed writeScannerSettings(_db.getTLSSession(), lastScanSettingsName, _settings); _lastScanSettings = _settings; LMS_LOG(DBUPDATER, DEBUG, "Scan not aborted, scheduling next scan!"); scheduleNextScan(); _events.scanComplete.emit(stats); } else { LMS_LOG(DBUPDATER, DEBUG, "Scan aborted, not scheduling next scan!"); } } void ScannerService::processScanSteps(ScanContext& context) { std::size_t stepIndex{}; for (auto& scanStep : _scanSteps) { context.currentStepStats = ScanStepStats{ .startTime = Wt::WDateTime::currentDateTime(), .stepCount = _scanSteps.size(), .stepIndex = stepIndex++, .currentStep = scanStep->getStep(), .totalElems = 0, .processedElems = 0 }; if (_abortScan) break; if (!scanStep->needProcess(context)) { LMS_LOG(DBUPDATER, DEBUG, "Skipping scan step '" << scanStep->getStepName() << "'"); continue; } { LMS_SCOPED_TRACE_OVERVIEW("Scanner", scanStep->getStepName()); LMS_LOG(DBUPDATER, DEBUG, "Starting scan step '" << scanStep->getStepName() << "'"); notifyInProgress(context.currentStepStats); scanStep->process(context); notifyInProgress(context.currentStepStats); LMS_LOG(DBUPDATER, DEBUG, "Completed scan step '" << scanStep->getStepName() << "'"); } } } void ScannerService::refreshScanSettings() { std::optional newSettings{ readScannerSettings(_db.getTLSSession(), currentSettingsName) }; assert(newSettings.has_value()); if (_settings == *newSettings) return; LMS_LOG(DBUPDATER, DEBUG, "Scanner settings updated"); LMS_LOG(DBUPDATER, DEBUG, "Using audio scan version " << newSettings->audioScanVersion); LMS_LOG(DBUPDATER, DEBUG, "Using artist info scan version " << newSettings->artistInfoScanVersion); _settings = std::move(*newSettings); if (!_lastScanSettings) _lastScanSettings = readScannerSettings(_db.getTLSSession(), lastScanSettingsName); auto progressFunc{ [this](const ScanStepStats& stats) { notifyInProgressIfNeeded(stats); } }; _fileScanners.clear(); _fileScanners.add(std::make_unique(_db, _settings)); _fileScanners.add(std::make_unique(_db, _settings)); _fileScanners.add(std::make_unique(_db, _settings)); _fileScanners.add(std::make_unique(_db, _settings)); _fileScanners.add(std::make_unique(_db, _settings)); _fileScanners.visit([](const IFileScanner& scanner) { for (const std::filesystem::path& file : scanner.getSupportedFiles()) LMS_LOG(DBUPDATER, INFO, scanner.getName() << ": supporting file " << file); for (const std::filesystem::path& extension : scanner.getSupportedExtensions()) LMS_LOG(DBUPDATER, INFO, scanner.getName() << ": supporting file extension " << extension); }); ScanStepBase::InitParams params{ .jobScheduler = *_jobScheduler, .settings = _settings, .lastScanSettings = _lastScanSettings.has_value() ? &(_lastScanSettings.value()) : nullptr, .progressCallback = progressFunc, .abortScan = _abortScan, .db = _db, .fileScanners = _fileScanners, }; // Order is important: steps are sequential _scanSteps.clear(); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); // must come after ScanStepAssociateReleaseImages _scanSteps.emplace_back(std::make_unique(params)); // must come after ScanStepAssociateReleaseImages _scanSteps.emplace_back(std::make_unique(params)); // must come after ScanStepAssociateMediumImages and ScanStepAssociateReleaseImages _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); _scanSteps.emplace_back(std::make_unique(params)); } void ScannerService::notifyInProgress(const ScanStepStats& stepStats) { { std::unique_lock lock{ _statusMutex }; _curState = State::InProgress; _currentScanStepStats = stepStats; } const auto now{ std::chrono::steady_clock::now() }; _events.scanInProgress.emit(stepStats); _lastScanInProgressEmit = now; } void ScannerService::notifyInProgressIfNeeded(const ScanStepStats& stepStats) { const auto now{ std::chrono::steady_clock::now() }; if (now - _lastScanInProgressEmit >= std::chrono::seconds{ 1 }) notifyInProgress(stepStats); } } // namespace lms::scanner