fileutils

func CleanupEmptyDirectory ¶

func CleanupEmptyDirectory(dirPath string) (bool, error)

CleanupEmptyDirectory removes a directory if it's empty. Returns true if the directory was removed, false if it wasn't empty or didn't exist.

func CleanupEmptyParentDirectories ¶

func CleanupEmptyParentDirectories(startPath, stopAt string) error

CleanupEmptyParentDirectories removes empty parent directories starting from startPath up to (but not including) stopAt.

func ComputeNewCoverPath ¶

func ComputeNewCoverPath(oldCoverPath, newFilePath string) string

ComputeNewCoverPath computes the new cover image path after a file has been renamed. It preserves the cover's extension while updating the base filename to match the new file path. Returns empty string if oldCoverPath is empty.

func CoverExistsWithBaseName ¶

func CoverExistsWithBaseName(dir, baseName string) string

CoverExistsWithBaseName checks if any cover file exists with the given base name, regardless of image extension. This allows users to provide custom covers that won't be overwritten even if the book would extract a different format.

Parameters:

• dir: the directory to check
• baseName: the cover base name without extension (e.g., "mybook.epub.cover")

Returns the path to the existing cover file if found, or empty string if no cover exists.

func ExtractSeriesFromTitle ¶

func ExtractSeriesFromTitle(title string, fileType string) (seriesName string, volumeNumber *float64, ok bool)

ExtractSeriesFromTitle extracts series name and volume number from a normalized title. Only applies to CBZ files with volume indicators in the "v{number}" format. Returns the base title (series name), volume number, and whether extraction succeeded.

func GenerateOrganizedFileName ¶

func GenerateOrganizedFileName(opts OrganizedNameOptions, originalFilepath string) string

GenerateOrganizedFileName creates a standardized filename: Title.ext. For M4B files, includes narrator in braces: Title {Narrator}.m4b. Author names are NOT included since files are already inside author-prefixed folders.

func GenerateOrganizedFolderName ¶

func GenerateOrganizedFolderName(opts OrganizedNameOptions) string

GenerateOrganizedFolderName creates a standardized folder name: [Author] Title #Volume.

func IsOrganizedName ¶

func IsOrganizedName(name string) bool

IsOrganizedName checks if a filename/foldername follows the organized naming pattern.

func MimeTypeFromExtension ¶

func MimeTypeFromExtension(ext string) string

MimeTypeFromExtension returns the MIME type for a given file extension. Returns empty string if the extension is not recognized.

func NormalizeImage ¶

func NormalizeImage(data []byte, mimeType string) ([]byte, string, error)

NormalizeImage decodes and re-encodes an image to strip problematic metadata (like gAMA chunks without sRGB in PNG) that cause color rendering issues in browsers. Returns the normalized image data and the new MIME type. If the input is a JPEG, it stays as JPEG to preserve quality. Otherwise, it becomes PNG.

func NormalizeVolumeInTitle ¶

func NormalizeVolumeInTitle(title string, fileType string) (string, bool)

NormalizeVolumeInTitle normalizes volume indicators in titles to the standard v{number} format. Only applies to CBZ files. Returns the normalized title and whether a volume was found.

func RenameOrganizedFile ¶

func RenameOrganizedFile(currentPath string, opts OrganizedNameOptions) (string, error)

RenameOrganizedFile renames an already organized file with new metadata. Also renames associated cover images, file sidecar, AND the book sidecar. Use this for BOOK-level changes (title, author changes) that should update the book sidecar. For FILE-level changes (file name, narrator), use RenameOrganizedFileOnly.

func RenameOrganizedFileOnly ¶

func RenameOrganizedFileOnly(currentPath string, opts OrganizedNameOptions) (string, error)

RenameOrganizedFileOnly renames a file with new metadata, but does NOT rename the book sidecar. Renames the file and its associated cover images and file-specific sidecar. Use this for FILE-level changes (file name, narrator) that should not affect the book sidecar. The book sidecar should only be renamed when book-level metadata (title, author) changes.

func RenameOrganizedFolder ¶

func RenameOrganizedFolder(currentFolderPath string, opts OrganizedNameOptions) (string, error)

RenameOrganizedFolder renames a folder containing organized files.

func SplitNames ¶

func SplitNames(s string) []string

SplitNames splits a string of names by common delimiters (comma and semicolon), trims whitespace from each name, and returns non-empty names. This is used for parsing author and narrator lists from metadata.