diff --git a/src/app/api/admin/settings/paths/route.ts b/src/app/api/admin/settings/paths/route.ts
index 9683702..b168a94 100644
--- a/src/app/api/admin/settings/paths/route.ts
+++ b/src/app/api/admin/settings/paths/route.ts
@@ -15,7 +15,7 @@ export async function PUT(request: NextRequest) {
return requireAuth(request, async (req: AuthenticatedRequest) => {
return requireAdmin(req, async () => {
try {
- const { downloadDir, mediaDir, audiobookPathTemplate, ebookPathTemplate, metadataTaggingEnabled, chapterMergingEnabled, fileRenameEnabled, fileRenameTemplate, fileChmod, dirChmod } = await request.json();
+ const { downloadDir, mediaDir, audiobookPathTemplate, ebookPathTemplate, metadataTaggingEnabled, chapterMergingEnabled, plexFormatCoercionEnabled, fileRenameEnabled, fileRenameTemplate, fileChmod, dirChmod } = await request.json();
if (!downloadDir || !mediaDir) {
return NextResponse.json(
@@ -112,6 +112,19 @@ export async function PUT(request: NextRequest) {
},
});
+ // Update Plex format coercion setting (issue #166: silently rename .mp4/.m4a to .m4b
+ // post-organize so Plex's audiobook library recognizes them without transcoding)
+ await prisma.configuration.upsert({
+ where: { key: 'plex_format_coercion_enabled' },
+ update: { value: String(plexFormatCoercionEnabled ?? true) },
+ create: {
+ key: 'plex_format_coercion_enabled',
+ value: String(plexFormatCoercionEnabled ?? true),
+ category: 'automation',
+ description: 'Rename audio files to Plex-compatible extensions (.mp4/.m4a -> .m4b) after organization to avoid silent library-scan failures',
+ },
+ });
+
// Update file rename setting
await prisma.configuration.upsert({
where: { key: 'file_rename_enabled' },
@@ -176,6 +189,7 @@ export async function PUT(request: NextRequest) {
configService.clearCache('ebook_path_template');
configService.clearCache('metadata_tagging_enabled');
configService.clearCache('chapter_merging_enabled');
+ configService.clearCache('plex_format_coercion_enabled');
configService.clearCache('file_rename_enabled');
configService.clearCache('file_rename_template');
configService.clearCache('file_chmod');
diff --git a/src/app/api/admin/settings/route.ts b/src/app/api/admin/settings/route.ts
index 59ccf3f..08163d2 100644
--- a/src/app/api/admin/settings/route.ts
+++ b/src/app/api/admin/settings/route.ts
@@ -134,6 +134,7 @@ export async function GET(request: NextRequest) {
ebookPathTemplate: configMap.get('ebook_path_template') || configMap.get('audiobook_path_template') || '{author}/{title} {asin}',
metadataTaggingEnabled: configMap.get('metadata_tagging_enabled') === 'true',
chapterMergingEnabled: configMap.get('chapter_merging_enabled') === 'true',
+ plexFormatCoercionEnabled: configMap.get('plex_format_coercion_enabled') !== 'false',
fileRenameEnabled: configMap.get('file_rename_enabled') === 'true',
fileRenameTemplate: configMap.get('file_rename_template') || '{title}',
fileChmod: configMap.get('file_chmod') || '664',
diff --git a/src/app/api/setup/complete/route.ts b/src/app/api/setup/complete/route.ts
index 637e0da..1cc4228 100644
--- a/src/app/api/setup/complete/route.ts
+++ b/src/app/api/setup/complete/route.ts
@@ -469,6 +469,19 @@ export async function POST(request: NextRequest) {
},
});
+ // Plex format coercion configuration (issue #166: silently rename .mp4/.m4a to .m4b
+ // post-organize so Plex's audiobook library recognizes them without transcoding)
+ await prisma.configuration.upsert({
+ where: { key: 'plex_format_coercion_enabled' },
+ update: { value: String(paths.plex_format_coercion_enabled ?? true) },
+ create: {
+ key: 'plex_format_coercion_enabled',
+ value: String(paths.plex_format_coercion_enabled ?? true),
+ category: 'automation',
+ description: 'Rename audio files to Plex-compatible extensions (.mp4/.m4a -> .m4b) after organization to avoid silent library-scan failures'
+ },
+ });
+
// BookDate configuration (optional, global for all users)
// Note: libraryScope and customPrompt are now per-user settings, not required here
if (bookdate && bookdate.provider && bookdate.apiKey && bookdate.model) {
diff --git a/src/app/setup/page.tsx b/src/app/setup/page.tsx
index 067228c..b980c9c 100644
--- a/src/app/setup/page.tsx
+++ b/src/app/setup/page.tsx
@@ -87,6 +87,7 @@ interface SetupState {
downloadDir: string;
mediaDir: string;
metadataTaggingEnabled: boolean;
+ plexFormatCoercionEnabled: boolean;
chapterMergingEnabled: boolean;
bookdateProvider: string;
bookdateApiKey: string;
@@ -161,6 +162,7 @@ export default function SetupWizard() {
downloadDir: '/downloads',
mediaDir: '/media/audiobooks',
metadataTaggingEnabled: true,
+ plexFormatCoercionEnabled: true,
chapterMergingEnabled: false,
bookdateProvider: 'openai',
bookdateApiKey: '',
@@ -237,6 +239,7 @@ export default function SetupWizard() {
download_dir: state.downloadDir,
media_dir: state.mediaDir,
metadata_tagging_enabled: state.metadataTaggingEnabled,
+ plex_format_coercion_enabled: state.plexFormatCoercionEnabled,
chapter_merging_enabled: state.chapterMergingEnabled,
},
bookdate: state.bookdateConfigured ? {
@@ -537,6 +540,7 @@ export default function SetupWizard() {
downloadDir={state.downloadDir}
mediaDir={state.mediaDir}
metadataTaggingEnabled={state.metadataTaggingEnabled}
+ plexFormatCoercionEnabled={state.plexFormatCoercionEnabled}
chapterMergingEnabled={state.chapterMergingEnabled}
pathsTested={state.pathsTested}
onUpdate={updateField}
diff --git a/src/app/setup/steps/PathsStep.tsx b/src/app/setup/steps/PathsStep.tsx
index fb3b4cf..58a2df7 100644
--- a/src/app/setup/steps/PathsStep.tsx
+++ b/src/app/setup/steps/PathsStep.tsx
@@ -13,6 +13,7 @@ interface PathsStepProps {
downloadDir: string;
mediaDir: string;
metadataTaggingEnabled: boolean;
+ plexFormatCoercionEnabled: boolean;
chapterMergingEnabled: boolean;
pathsTested: boolean;
onUpdate: (field: string, value: any) => void;
@@ -24,6 +25,7 @@ export function PathsStep({
downloadDir,
mediaDir,
metadataTaggingEnabled,
+ plexFormatCoercionEnabled,
chapterMergingEnabled,
pathsTested,
onUpdate,
@@ -246,6 +248,30 @@ export function PathsStep({
+ {/* Plex Format Coercion Toggle */}
+