astra/astra-mobile
1
0
Fork 0
mirror of https://github.com/Boof2015/astra-mobile.git synced 2026-08-19 20:20:18 +02:00
Code Issues Packages Projects Releases Wiki Activity

support sidecar and embedded lyrics

Browse Source
This commit is contained in:
Boof2015
2026-07-15 15:02:49 -04:00
parent b5f1ca9e99
commit 92128b0b99
13 changed files with 825 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
modules/astra-library-scanner/index.ts
+16 -6
View File
@@ -57,11 +57,21 @@ export interface SidecarLyrics {
format: 'xlrc' | 'lrc';
}
/** Embedded lyrics text read from container tags. */
export interface EmbeddedLyrics {
export interface EmbeddedLyricsSyncText {
timestampMs: number;
text: string;
}
/** Embedded lyrics read from container tags without decoding audio. */
export type EmbeddedLyricsReadResult =
| {
status: 'hit';
text: string | null;
syncText: EmbeddedLyricsSyncText[];
}
| { status: 'missing' }
| { status: 'unavailable' };
export interface ScanProgressEvent {
phase: 'discovering';
found: number;
@@ -103,11 +113,11 @@ declare class AstraLibraryScannerModuleType extends NativeModule<AstraLibrarySca
*/
readSidecarLyrics(uri: string): Promise<SidecarLyrics | null>;
/**
* Read embedded lyrics from container tags (Vorbis LYRICS/UNSYNCEDLYRICS for
* FLAC/Ogg/Opus, TXXX:LYRICS, MP4 lyric atoms) without decoding audio. Null when
* absent. ID3 USLT/SYLT are not covered (ExoPlayer leaves them undecoded).
* Read embedded lyrics from Vorbis, ID3 (USLT/SYLT/TXXX), and MP4/M4A tags
* without decoding audio. `missing` means metadata was read successfully but
* no supported tag was present; `unavailable` preserves cache on I/O failure.
*/
readEmbeddedLyrics(uri: string): Promise<EmbeddedLyrics | null>;
readEmbeddedLyrics(uri: string): Promise<EmbeddedLyricsReadResult>;
getArtworkDirPath(): string;
getArtworkThumbDirPath(): string;
ensureArtworkThumbnails(hashes: string[]): Promise<number>;