From c61bfb4134cb1b3111e8d0efe98393bab6915f0e Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Mon, 10 Nov 2025 21:42:06 -0700
Subject: [PATCH 01/18] Fix EditQuickFilters not displaying with no filters

---
 Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml.cs b/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml.cs
index 65c21922..aa51b7ed 100644
--- a/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml.cs
@@ -66,8 +66,11 @@ namespace LibationAvalonia.Dialogs
 			ControlToFocusOnShow = this.FindControl<Button>(nameof(saveBtn));
 
 			var allFilters = QuickFilters.Filters.Select(f => new Filter { FilterString = f.Filter, Name = f.Name }).ToList();
-			allFilters[0].IsTop = true;
-			allFilters[^1].IsBottom = true;
+			if (allFilters.Count > 0)
+			{
+				allFilters[0].IsTop = true;
+				allFilters[^1].IsBottom = true;
+			}
 			allFilters.Add(new Filter());
 
 			foreach (var f in allFilters)

From e5043dcf40277a3a3c659a553a05d7460119696e Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Mon, 10 Nov 2025 21:42:34 -0700
Subject: [PATCH 02/18] Move button styling to App.xaml

---
 Source/LibationAvalonia/App.axaml                         | 6 +++++-
 Source/LibationAvalonia/Dialogs/AccountsDialog.axaml      | 8 --------
 Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml   | 6 ------
 Source/LibationAvalonia/Dialogs/BookRecordsDialog.axaml   | 8 --------
 Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml    | 8 --------
 .../Dialogs/LiberatedStatusBatchAutoDialog.axaml          | 1 +
 .../Dialogs/LiberatedStatusBatchAutoDialog.axaml.cs       | 1 +
 .../Dialogs/LiberatedStatusBatchManualDialog.axaml        | 1 +
 .../Dialogs/LiberatedStatusBatchManualDialog.axaml.cs     | 1 +
 Source/LibationAvalonia/Dialogs/MessageBoxWindow.axaml    | 6 ------
 Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml  | 8 --------
 11 files changed, 9 insertions(+), 45 deletions(-)

diff --git a/Source/LibationAvalonia/App.axaml b/Source/LibationAvalonia/App.axaml
index a2499ea8..a8dfab59 100644
--- a/Source/LibationAvalonia/App.axaml
+++ b/Source/LibationAvalonia/App.axaml
@@ -97,7 +97,11 @@
 					<ContentPresenter Background="{DynamicResource SystemRegionColor}" Content="{TemplateBinding Content}" />
 				</ControlTemplate>
 			</Setter>
-		</Style>		
+			<Style Selector="^ Button:focus">
+				<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
+				<Setter Property="BorderThickness" Value="2" />
+			</Style>
+		</Style>
 	</Application.Styles>
 
 	<NativeMenu.Menu>
diff --git a/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml b/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml
index b6ef31d0..39e3ed35 100644
--- a/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml
@@ -7,14 +7,6 @@
         x:Class="LibationAvalonia.Dialogs.AccountsDialog"
         Title="Audible Accounts">
 	<Grid RowDefinitions="*,Auto">
-
-		<Grid.Styles>
-			<Style Selector="Button:focus">
-				<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
-				<Setter Property="BorderThickness" Value="2" />
-			</Style>
-		</Grid.Styles>
-
 		<DataGrid
 			Grid.Row="0"
 			CanUserReorderColumns="False"
diff --git a/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml b/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml
index 2d308e1c..f877f60a 100644
--- a/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml
@@ -13,12 +13,6 @@
         Title="Book Details" Name="BookDetails">
 
 	<Grid RowDefinitions="*,Auto,Auto,40">
-		<Grid.Styles>
-			<Style Selector="Button:focus">
-				<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
-				<Setter Property="BorderThickness" Value="2" />
-			</Style>
-		</Grid.Styles>
 		<Grid ColumnDefinitions="Auto,*" RowDefinitions="Auto,*,Auto" Margin="10">
 			<Image Source="{Binding Cover}" />
 
diff --git a/Source/LibationAvalonia/Dialogs/BookRecordsDialog.axaml b/Source/LibationAvalonia/Dialogs/BookRecordsDialog.axaml
index e181d106..e34071c6 100644
--- a/Source/LibationAvalonia/Dialogs/BookRecordsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/BookRecordsDialog.axaml
@@ -8,14 +8,6 @@
         Title="BookRecordsDialog">
 
 	<Grid RowDefinitions="*,Auto">
-
-		<Grid.Styles>
-			<Style Selector="Button:focus">
-				<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
-				<Setter Property="BorderThickness" Value="2" />
-			</Style>
-		</Grid.Styles>
-
 		<DataGrid
 			Grid.Row="0"
 			CanUserReorderColumns="True"
diff --git a/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml b/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml
index 68f41b76..c8fcaf33 100644
--- a/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml
+++ b/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml
@@ -9,14 +9,6 @@
         Title="Edit Quick Filters"
 		x:DataType="dialogs:EditQuickFilters">
 	<Grid RowDefinitions="*,Auto">
-
-		<Grid.Styles>
-			<Style Selector="Button:focus">
-				<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
-				<Setter Property="BorderThickness" Value="2" />
-			</Style>
-		</Grid.Styles>
-
 		<DataGrid
 			Grid.Row="0"
 			CanUserReorderColumns="False"
diff --git a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml
index cdd05454..be6a419d 100644
--- a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml
@@ -38,6 +38,7 @@
 		<Button
 			Grid.Row="1"
 			Padding="30,5"
+			Name="SaveButton"
 			HorizontalAlignment="Right"
 			Content="Save"
 			Command="{Binding SaveAndClose}"/>
diff --git a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml.cs
index 13605591..1e5c2ee3 100644
--- a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml.cs
@@ -9,6 +9,7 @@ namespace LibationAvalonia.Dialogs
 		{
 			InitializeComponent();
 			DataContext = this;
+			ControlToFocusOnShow = SaveButton;
 		}
 	}
 }
diff --git a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml
index b28a5bc8..2ff0185b 100644
--- a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml
@@ -57,6 +57,7 @@
 			VerticalAlignment="Stretch"
 			HorizontalAlignment="Right"
 			Content="Save"
+			Name="SaveButton"
 			Click="SaveButton_Clicked" />
 	</Grid>
 </Window>
diff --git a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml.cs
index acaa90af..bd56702e 100644
--- a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml.cs
@@ -44,6 +44,7 @@ namespace LibationAvalonia.Dialogs
 			InitializeComponent();
 			SelectedItem = BookStatuses[0] as liberatedComboBoxItem;
 			DataContext = this;
+			ControlToFocusOnShow = SaveButton;
 		}
 
 		public void SaveButton_Clicked(object sender, Avalonia.Interactivity.RoutedEventArgs e)
diff --git a/Source/LibationAvalonia/Dialogs/MessageBoxWindow.axaml b/Source/LibationAvalonia/Dialogs/MessageBoxWindow.axaml
index 2b2ef05b..85708c1f 100644
--- a/Source/LibationAvalonia/Dialogs/MessageBoxWindow.axaml
+++ b/Source/LibationAvalonia/Dialogs/MessageBoxWindow.axaml
@@ -36,12 +36,6 @@
 		</DockPanel>
 
 		<DockPanel Height="45" Grid.Row="1" Background="{DynamicResource SystemChromeMediumLowColor}">
-			<DockPanel.Styles>
-				<Style Selector="Button:focus">
-					<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
-					<Setter Property="BorderThickness" Value="2" />
-				</Style>
-			</DockPanel.Styles>
 			<StackPanel Orientation="Horizontal" HorizontalAlignment="Right" Margin="5" DockPanel.Dock="Bottom">
 				<Button Grid.Column="0" MinWidth="75" MinHeight="28" Name="Button1" Click="Button1_Click" Margin="5">
 					<TextBlock VerticalAlignment="Center" HorizontalAlignment="Center" Text="{CompiledBinding Button1Text}"/>
diff --git a/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml b/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml
index 0ee7fd99..f0cb0686 100644
--- a/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml
@@ -18,14 +18,6 @@
 		ColumnDefinitions="*,Auto"
 		RowDefinitions="Auto,*,Auto"
 		Margin="10">
-		
-		<Grid.Styles>
-			<Style Selector="Button:focus">
-				<Setter Property="BorderBrush" Value="{DynamicResource SystemAccentColor}" />
-				<Setter Property="BorderThickness" Value="2" />
-			</Style>
-		</Grid.Styles>
-		
 		<TextBlock
 			Grid.Row="0"
 			Grid.Column="0"

From 5d2513ec338db68bc427551f033cbbe67736e357 Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Mon, 10 Nov 2025 22:21:51 -0700
Subject: [PATCH 03/18] Improve button display size uniformity.

---
 Source/LibationAvalonia/App.axaml                            | 3 +++
 Source/LibationAvalonia/Controls/Settings/Audio.axaml        | 2 +-
 Source/LibationAvalonia/Dialogs/AccountsDialog.axaml         | 3 +--
 Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml      | 2 +-
 Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml       | 2 +-
 Source/LibationAvalonia/Dialogs/EditReplacementChars.axaml   | 2 +-
 Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml     | 2 +-
 Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml    | 2 +-
 .../Dialogs/LiberatedStatusBatchAutoDialog.axaml             | 2 +-
 .../Dialogs/LiberatedStatusBatchManualDialog.axaml           | 2 +-
 .../LibationAvalonia/Dialogs/Login/LoginExternalDialog.axaml | 3 ++-
 .../Dialogs/MessageBoxAlertAdminDialog.axaml                 | 5 ++---
 Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml     | 2 +-
 Source/LibationAvalonia/Dialogs/SettingsDialog.axaml         | 3 +--
 Source/LibationAvalonia/Dialogs/TagsBatchDialog.axaml        | 2 +-
 Source/LibationAvalonia/Dialogs/ThemePickerDialog.axaml      | 3 +--
 .../LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml | 3 ++-
 .../Dialogs/UpgradeNotificationDialog.axaml.cs               | 1 +
 Source/LibationAvalonia/Views/MainWindow.axaml               | 5 ++---
 Source/LibationAvalonia/Views/ProcessBookControl.axaml       | 2 +-
 20 files changed, 26 insertions(+), 25 deletions(-)

diff --git a/Source/LibationAvalonia/App.axaml b/Source/LibationAvalonia/App.axaml
index a8dfab59..75763c08 100644
--- a/Source/LibationAvalonia/App.axaml
+++ b/Source/LibationAvalonia/App.axaml
@@ -84,6 +84,9 @@
 				<Setter Property="Foreground" Value="{DynamicResource SystemChromeAltLowColor}" />
 			</Style>
 		</Style>
+		<Style Selector="Button.SaveButton">
+			<Setter Property="Padding" Value="30,6" />
+		</Style>
 		<Style Selector="ScrollBar">
 			<!-- It's called AutoHide, but this is really the mouseover shrink/expand. -->
             <Setter Property="AllowAutoHide" Value="false"/>
diff --git a/Source/LibationAvalonia/Controls/Settings/Audio.axaml b/Source/LibationAvalonia/Controls/Settings/Audio.axaml
index 54d77e86..333d7845 100644
--- a/Source/LibationAvalonia/Controls/Settings/Audio.axaml
+++ b/Source/LibationAvalonia/Controls/Settings/Audio.axaml
@@ -412,7 +412,7 @@
 				<Button
 					Grid.Column="1"
 					Content="Edit"
-					Padding="30,0"
+					Classes="SaveButton"
 					Margin="10,0,0,0"
 					VerticalAlignment="Stretch"
 					Click="EditChapterTitleTemplateButton_Click" />
diff --git a/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml b/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml
index 39e3ed35..e0e26f7b 100644
--- a/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/AccountsDialog.axaml
@@ -99,13 +99,12 @@
 
 			<Button
 				Grid.Column="0"
-				Padding="5,5"
 				Content="Import from audible-cli"
 				Click="ImportButton_Clicked" />
 
 			<Button
 				Grid.Column="1"
-				Padding="30,5"
+				Classes="SaveButton"
 				Content="Save"
 				Click="SaveButton_Clicked" />
 		</Grid>
diff --git a/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml b/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml
index f877f60a..33c0d925 100644
--- a/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/BookDetailsDialog.axaml
@@ -140,7 +140,7 @@
 			<Button
 				Grid.Column="1"
 				Content="Save"
-				Padding="30,3,30,3"
+				Classes="SaveButton"
 				Click="SaveButton_Clicked" />
 		</Grid>
 		
diff --git a/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml b/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml
index c8fcaf33..5cb8f9f4 100644
--- a/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml
+++ b/Source/LibationAvalonia/Dialogs/EditQuickFilters.axaml
@@ -100,7 +100,7 @@
 
 			<Button
 				Grid.Column="1"
-				Padding="30,5"
+				Classes="SaveButton"
 				Name="saveBtn"
 				Content="Save"
 				Command="{Binding SaveAndClose}" />
diff --git a/Source/LibationAvalonia/Dialogs/EditReplacementChars.axaml b/Source/LibationAvalonia/Dialogs/EditReplacementChars.axaml
index 67e257d8..74c46309 100644
--- a/Source/LibationAvalonia/Dialogs/EditReplacementChars.axaml
+++ b/Source/LibationAvalonia/Dialogs/EditReplacementChars.axaml
@@ -75,7 +75,7 @@
 			<Button Grid.Row="1" Grid.Column="3" IsVisible="{Binding !EnvironmentIsWindows}" Command="{Binding Barebones}" CommandParameter="True" Content="Barebones" />
 						
 			<Button Grid.RowSpan="2" Grid.Column="4" Command="{Binding Close}" Content="Cancel" />
-			<Button Grid.RowSpan="2" Grid.Column="5" Padding="20,6" Command="{Binding SaveAndClose}" Content="Save" />
+			<Button Grid.RowSpan="2" Grid.Column="5" Classes="SaveButton" Command="{Binding SaveAndClose}" Content="Save" />
 		</Grid>	
 	</Grid>	
 </Window>
diff --git a/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml b/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml
index 57749c32..b535fba4 100644
--- a/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml
@@ -110,7 +110,7 @@
 			Command="{Binding GoToNamingTemplateWiki}" />
 		<Button
 			Grid.Row="2"
-			Padding="30,5,30,5"
+				Classes="SaveButton"
 			HorizontalAlignment="Right"
 			Content="Save"
 			Click="SaveButton_Click" />
diff --git a/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml b/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml
index 5c66986e..cd868d9e 100644
--- a/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml
@@ -25,7 +25,7 @@
 			Grid.Row="1"
 			HorizontalAlignment="Right"
 			Margin="5"
-			Padding="30,3,30,3"
+			Classes="SaveButton"
 			Content="Save"
 			Click="Save_Click" />
 	</Grid>
diff --git a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml
index be6a419d..a6aa46d5 100644
--- a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchAutoDialog.axaml
@@ -37,7 +37,7 @@
 		
 		<Button
 			Grid.Row="1"
-			Padding="30,5"
+			Classes="SaveButton"
 			Name="SaveButton"
 			HorizontalAlignment="Right"
 			Content="Save"
diff --git a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml
index 2ff0185b..9ebd795f 100644
--- a/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/LiberatedStatusBatchManualDialog.axaml
@@ -53,7 +53,7 @@
 			Grid.Row="1"
 			Grid.Column="1"
 			Margin="10,0"
-			Padding="30,5"
+			Classes="SaveButton"
 			VerticalAlignment="Stretch"
 			HorizontalAlignment="Right"
 			Content="Save"
diff --git a/Source/LibationAvalonia/Dialogs/Login/LoginExternalDialog.axaml b/Source/LibationAvalonia/Dialogs/Login/LoginExternalDialog.axaml
index 4c070927..d4376236 100644
--- a/Source/LibationAvalonia/Dialogs/Login/LoginExternalDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/Login/LoginExternalDialog.axaml
@@ -102,7 +102,8 @@
 			<Button
 				Grid.Row="1"
 				Margin="0,5,0,0"
-				Padding="30,3,30,3" HorizontalAlignment="Right"
+				Classes="SaveButton"
+				HorizontalAlignment="Right"
 				Content="Submit"
 				Click="Submit_Click" />
 		</Grid>
diff --git a/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml b/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml
index eebd8765..410de601 100644
--- a/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml
@@ -64,11 +64,10 @@
 
 		<Button
 			Grid.Row="3"
-			Height="30"
 			HorizontalAlignment="Center"
-			Margin="10,10,10,10"
-			Padding="30,3,30,3"
+			Margin="10"
 			Name="OkButton"
+			Classes="SaveButton"
 			Content="Ok"
 			Click="OkButton_Clicked" />
 	</Grid>
diff --git a/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml b/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml
index f0cb0686..a4531b19 100644
--- a/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/ScanAccountsDialog.axaml
@@ -53,7 +53,7 @@
 		<Button
 			Grid.Row="2"
 			Grid.Column="1"
-			Padding="30,6"
+			Classes="SaveButton"
 			HorizontalAlignment="Right"
 			Content="Import"
 			Name="ImportButton"
diff --git a/Source/LibationAvalonia/Dialogs/SettingsDialog.axaml b/Source/LibationAvalonia/Dialogs/SettingsDialog.axaml
index 7d0939ff..cba6c958 100644
--- a/Source/LibationAvalonia/Dialogs/SettingsDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/SettingsDialog.axaml
@@ -18,8 +18,7 @@
 			Grid.Row="1"
 			Margin="10"
 			HorizontalAlignment="Right"
-			Height="30"
-			Padding="30,3,30,3"
+			Classes="SaveButton"
 			Content="Save"
 			Name="saveBtn"
 			Click="SaveButton_Clicked" />
diff --git a/Source/LibationAvalonia/Dialogs/TagsBatchDialog.axaml b/Source/LibationAvalonia/Dialogs/TagsBatchDialog.axaml
index 999ccf1e..925fdc9a 100644
--- a/Source/LibationAvalonia/Dialogs/TagsBatchDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/TagsBatchDialog.axaml
@@ -24,7 +24,7 @@
 			Grid.Row="1"
 			Grid.Column="1"
 			Margin="10,0,0,0"
-			Padding="20,3"
+			Classes="SaveButton"
 			VerticalAlignment="Stretch"
 			Content="Save"
 			Command="{Binding SaveAndClose}"/>
diff --git a/Source/LibationAvalonia/Dialogs/ThemePickerDialog.axaml b/Source/LibationAvalonia/Dialogs/ThemePickerDialog.axaml
index 87399a3a..e86418f9 100644
--- a/Source/LibationAvalonia/Dialogs/ThemePickerDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/ThemePickerDialog.axaml
@@ -14,8 +14,7 @@
 			RowDefinitions="*,Auto,Auto">
 			<Grid.Styles>
 				<Style Selector="Button">
-					<Setter Property="Height" Value="30" />
-					<Setter Property="Padding" Value="20,0" />
+					<Setter Property="Padding" Value="20,6" />
 					<Setter Property="Margin" Value="5" />
 				</Style>
 			</Grid.Styles>
diff --git a/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml b/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml
index 2ec74e26..064f5361 100644
--- a/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml
+++ b/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml
@@ -77,7 +77,8 @@
 				Grid.Column="1"
 				TabIndex="0"
 				FontSize="16"
-				Padding="30,0,30,0"
+				Name="btnYes"
+				Classes="SaveButton"
 				VerticalAlignment="Stretch"
 				HorizontalAlignment="Right"
 				VerticalContentAlignment="Center"
diff --git a/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml.cs
index 618d3a06..4a586680 100644
--- a/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/UpgradeNotificationDialog.axaml.cs
@@ -27,6 +27,7 @@ namespace LibationAvalonia.Dialogs
 			}
 
 			InitializeComponent();
+			ControlToFocusOnShow = btnYes;
 		}
 
 		public UpgradeNotificationDialog(UpgradeProperties upgradeProperties, bool canUpgrade) : this()
diff --git a/Source/LibationAvalonia/Views/MainWindow.axaml b/Source/LibationAvalonia/Views/MainWindow.axaml
index 5934c5a1..9b05ad53 100644
--- a/Source/LibationAvalonia/Views/MainWindow.axaml
+++ b/Source/LibationAvalonia/Views/MainWindow.axaml
@@ -173,9 +173,8 @@
 					<Setter Property="MinHeight" Value="10" />
 				</Style>
 				<Style Selector="Button">
-					<Setter Property="Padding" Value="15,0,15,0" />
+					<Setter Property="Padding" Value="15,6" />
 					<Setter Property="Margin" Value="10,0,0,0" />
-					<Setter Property="Height" Value="30" />
 					<Setter Property="HorizontalContentAlignment" Value="Center" />
 					<Setter Property="VerticalContentAlignment" Value="Center" />
 				</Style>
@@ -195,7 +194,7 @@
 
 			<StackPanel Grid.Column="2" Height="30" Orientation="Horizontal">
 				<Button Name="filterBtn" Command="{CompiledBinding FilterBtn}" CommandParameter="{CompiledBinding #filterSearchTb.Text}" VerticalAlignment="Stretch" HorizontalContentAlignment="Center" VerticalContentAlignment="Center" Content="Filter"/>
-				<Button Padding="2,6,2,6" VerticalAlignment="Stretch" Command="{CompiledBinding ToggleQueueHideBtn}">
+				<Button Padding="2,6" VerticalAlignment="Stretch" Command="{CompiledBinding ToggleQueueHideBtn}">
 					<Path Stretch="Uniform" Fill="{DynamicResource IconFill}" Data="{StaticResource	LeftArrows}">
 						<Path.RenderTransform>
 							<RotateTransform Angle="{CompiledBinding QueueButtonAngle}"/>
diff --git a/Source/LibationAvalonia/Views/ProcessBookControl.axaml b/Source/LibationAvalonia/Views/ProcessBookControl.axaml
index 1796257f..f5b9d15e 100644
--- a/Source/LibationAvalonia/Views/ProcessBookControl.axaml
+++ b/Source/LibationAvalonia/Views/ProcessBookControl.axaml
@@ -55,7 +55,7 @@
 			<Grid Name="ButtonsGrid" Margin="3" Grid.Column="2" HorizontalAlignment="Right" ColumnDefinitions="Auto,Auto">
 				<Grid.Styles>
 					<Style Selector="Button">
-						<Setter Property="Padding" Value="0,1,0,1" />
+						<Setter Property="Padding" Value="0,1" />
 						<Setter Property="Height" Value="20" />
 						<Setter Property="Width" Value="30" />
 						<Style Selector="^ > Path">

From d16eeea56b23c09fe360b3c7e4041366b55d9173 Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Mon, 10 Nov 2025 22:44:24 -0700
Subject: [PATCH 04/18] Improve detection of NativeWebDialog crash

---
 .../Dialogs/Login/AvaloniaLoginChoiceEager.cs          | 10 ----------
 Source/LibationAvalonia/Program.cs                     |  2 +-
 .../ViewModels/Settings/AudioSettingsVM.cs             |  2 +-
 3 files changed, 2 insertions(+), 12 deletions(-)

diff --git a/Source/LibationAvalonia/Dialogs/Login/AvaloniaLoginChoiceEager.cs b/Source/LibationAvalonia/Dialogs/Login/AvaloniaLoginChoiceEager.cs
index 00a56041..acc8d686 100644
--- a/Source/LibationAvalonia/Dialogs/Login/AvaloniaLoginChoiceEager.cs
+++ b/Source/LibationAvalonia/Dialogs/Login/AvaloniaLoginChoiceEager.cs
@@ -53,7 +53,6 @@ namespace LibationAvalonia.Dialogs.Login
 				Source = new Uri(url)
 			};
 
-			dialog.AdapterCreated += Dialog_AdapterCreated;
 			dialog.NavigationCompleted += Dialog_NavigationCompleted;
 			dialog.Closing += (_, _) => tcs.TrySetResult(null);
 			dialog.NavigationStarted += (_, e) =>
@@ -81,15 +80,6 @@ namespace LibationAvalonia.Dialogs.Login
 			}
 		}
 
-		private void Dialog_AdapterCreated(object? sender, WebViewAdapterEventArgs e)
-		{
-			if ((sender as NativeWebDialog)?.TryGetWindow() is Window window)
-			{
-				window.Width = 450;
-				window.Height = 700;
-			}
-		}
-
 		private static string getScript(string accountID) => $$"""
 			(function() {
 				function populateForm(){
diff --git a/Source/LibationAvalonia/Program.cs b/Source/LibationAvalonia/Program.cs
index ff5c7709..a5ad6097 100644
--- a/Source/LibationAvalonia/Program.cs
+++ b/Source/LibationAvalonia/Program.cs
@@ -65,7 +65,7 @@ namespace LibationAvalonia
 			}
 			catch (Exception ex)
 			{
-				if (new StackTrace(ex).GetFrames().Any(f => f.GetMethod()?.DeclaringType == typeof(NativeWebDialog)))
+				if (new StackTrace(ex).GetFrames().Any(f => f.GetMethod()?.DeclaringType?.Assembly == typeof(NativeWebDialog).Assembly))
 				{
 					//Many of the NativeWebDialog exceptions cannot be handled by user code,
 					//so a webview failure is a fatal error. Disable webview usage and rely
diff --git a/Source/LibationAvalonia/ViewModels/Settings/AudioSettingsVM.cs b/Source/LibationAvalonia/ViewModels/Settings/AudioSettingsVM.cs
index ee1d5a90..44b0e90c 100644
--- a/Source/LibationAvalonia/ViewModels/Settings/AudioSettingsVM.cs
+++ b/Source/LibationAvalonia/ViewModels/Settings/AudioSettingsVM.cs
@@ -28,7 +28,7 @@ namespace LibationAvalonia.ViewModels.Settings
 		public AvaloniaList<EnumDisplay<SampleRate>> SampleRates { get; }
 				= new(Enum.GetValues<SampleRate>()
 				.Where(r => r >= SampleRate.Hz_8000 && r <= SampleRate.Hz_48000)
-				.Select(v => new EnumDisplay<SampleRate>(v, $"{(int)v} Hz")));
+				.Select(v => new EnumDisplay<SampleRate>(v, $"{((int)v):N0} Hz")));
 
 		public AvaloniaList<NAudio.Lame.EncoderQuality> EncoderQualities { get; }
 		= new(

From a3d181b2ecd712e7dc30b7ce963c353e210a630d Mon Sep 17 00:00:00 2001
From: MBucari <mbucari1@gmail.com>
Date: Tue, 11 Nov 2025 03:21:20 -0700
Subject: [PATCH 05/18] Fix Primary Screen NRE (#1420)

---
 .../Dialogs/DescriptionDisplayDialog.axaml.cs          | 10 ++++++----
 Source/LibationAvalonia/FormSaveExtension.cs           |  2 +-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/Source/LibationAvalonia/Dialogs/DescriptionDisplayDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/DescriptionDisplayDialog.axaml.cs
index 8a33783b..993c8861 100644
--- a/Source/LibationAvalonia/Dialogs/DescriptionDisplayDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/DescriptionDisplayDialog.axaml.cs
@@ -1,13 +1,15 @@
 using Avalonia;
 using Avalonia.Controls;
 using System;
+using System.Linq;
 
+#nullable enable
 namespace LibationAvalonia.Dialogs
 {
 	public partial class DescriptionDisplayDialog : Window
 	{
 		public Point SpawnLocation { get; set; }
-		public string DescriptionText { get; init; }
+		public string? DescriptionText { get; init; }
 		public DescriptionDisplayDialog()
 		{
 			InitializeComponent();
@@ -17,15 +19,15 @@ namespace LibationAvalonia.Dialogs
 			Opened += DescriptionDisplay_Opened;
 		}
 
-		private void DescriptionDisplay_Opened(object sender, EventArgs e)
+		private void DescriptionDisplay_Opened(object? sender, EventArgs e)
 		{
 			DescriptionTextBox.Focus();
 		}
 
-		private void DescriptionDisplay_Activated(object sender, EventArgs e)
+		private void DescriptionDisplay_Activated(object? sender, EventArgs e)
 		{
 			DataContext = this;
-			var workingHeight = this.Screens.Primary.WorkingArea.Height;
+			var workingHeight = (Screens.ScreenFromTopLevel(this) ?? Screens.Primary ?? Screens.All.FirstOrDefault())?.WorkingArea.Height ?? 1080;
 			DescriptionTextBox.Measure(new Size(DescriptionTextBox.MinWidth, workingHeight * 0.8));
 
 			this.Width = DescriptionTextBox.DesiredSize.Width;
diff --git a/Source/LibationAvalonia/FormSaveExtension.cs b/Source/LibationAvalonia/FormSaveExtension.cs
index 1dfa0a74..91fa42ed 100644
--- a/Source/LibationAvalonia/FormSaveExtension.cs
+++ b/Source/LibationAvalonia/FormSaveExtension.cs
@@ -41,7 +41,7 @@ namespace LibationAvalonia
 					savedState.Width = (int)form.Width;
 					savedState.Height = (int)form.Height;
 				}
-				if (form.Screens.Primary is Screen primaryScreen)
+				if ((form.Screens.Primary ?? form.Screens.All.FirstOrDefault()) is Screen primaryScreen)
 				{
 					// Fit to the current screen size in case the screen resolution changed since the size was last persisted
 					if (savedState.Width > primaryScreen.WorkingArea.Width)

From 717dfcd9239a0815b53e999f28bed1a1b7b1509d Mon Sep 17 00:00:00 2001
From: MBucari <mbucari1@gmail.com>
Date: Tue, 11 Nov 2025 14:06:54 -0700
Subject: [PATCH 06/18] Fix trying to cancel disposed cancellation token source

---
 Source/AaxDecrypter/NetworkFileStream.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/Source/AaxDecrypter/NetworkFileStream.cs b/Source/AaxDecrypter/NetworkFileStream.cs
index 769a76fc..ae9d961a 100644
--- a/Source/AaxDecrypter/NetworkFileStream.cs
+++ b/Source/AaxDecrypter/NetworkFileStream.cs
@@ -306,7 +306,7 @@ namespace AaxDecrypter
 				if (WritePosition > endPosition)
 					throw new WebException($"Downloaded size (0x{WritePosition:X10}) is greater than {nameof(ContentLength)} (0x{ContentLength:X10}).");
 			}
-			catch (TaskCanceledException)
+			catch (OperationCanceledException)
 			{
 				Serilog.Log.Information("Download was cancelled");
 			}
@@ -402,7 +402,7 @@ namespace AaxDecrypter
 		 */
 		protected override void Dispose(bool disposing)
 		{
-			if (disposing && !disposed)
+			if (disposing && !Interlocked.CompareExchange(ref disposed, true, false))
 			{
 				_cancellationSource.Cancel();
 				DownloadTask?.GetAwaiter().GetResult();
@@ -413,7 +413,6 @@ namespace AaxDecrypter
 				OnUpdate(waitForWrite: true);
 			}
 
-			disposed = true;
 			base.Dispose(disposing);
 		}
 

From 9f6d08fc1faafeed4df2ba1b06316fe09b7d827a Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Wed, 12 Nov 2025 10:41:52 -0700
Subject: [PATCH 07/18] Update Workflows

- Simplify workflows build commands
- Don't build ReadyToRun on validate
- Move get-version into it's own job in build.yml
- Split  macOS into it's own reusable workflow
  - Add app bundle code signing
  - Add notarization
---
 .github/workflows/build-linux.yml             | 125 ++++++------------
 .github/workflows/build-mac.yml               |  99 ++++++++++++++
 .github/workflows/build-windows.yml           | 116 ++++++----------
 .github/workflows/build.yml                   |  68 ++++++----
 .github/workflows/release.yml                 |   7 +-
 .github/workflows/validate.yml                |  20 ++-
 Scripts/Bundle_Debian.sh                      |   8 --
 Scripts/Bundle_MacOS.sh                       |  53 +++++---
 Scripts/Bundle_Redhat.sh                      |   8 --
 Source/LoadByOS/MacOSConfigApp/Info.plist     |  13 --
 .../MacOSConfigApp/Libation.entitlements      |  20 +++
 .../LoadByOS/MacOSConfigApp/Libation_DS_Store | Bin 0 -> 14340 bytes
 .../MacOSConfigApp/MacOSConfigApp.csproj      |  12 ++
 Source/LoadByOS/MacOSConfigApp/background.png | Bin 0 -> 12463 bytes
 14 files changed, 309 insertions(+), 240 deletions(-)
 create mode 100644 .github/workflows/build-mac.yml
 create mode 100644 Source/LoadByOS/MacOSConfigApp/Libation.entitlements
 create mode 100644 Source/LoadByOS/MacOSConfigApp/Libation_DS_Store
 create mode 100644 Source/LoadByOS/MacOSConfigApp/background.png

diff --git a/.github/workflows/build-linux.yml b/.github/workflows/build-linux.yml
index e76d1b87..91abad26 100644
--- a/.github/workflows/build-linux.yml
+++ b/.github/workflows/build-linux.yml
@@ -6,63 +6,46 @@ name: build
 on:
   workflow_call:
     inputs:
-      version_override:
+      libation-version:
         type: string
-        description: "Version number override"
-        required: false
-      run_unit_tests:
+        required: true
+      dotnet-version:
+        type: string
+        required: true
+      run-unit-tests:
         type: boolean
-        description: "Skip running unit tests"
-        required: false
-        default: true
-      runs_on:
+      publish-r2r:
+        type: boolean
+      retention-days:
+        type: number
+      architecture:
         type: string
-        description: "The GitHub hosted runner to use"
+        description: "CPU architecture targeted by the build."
         required: true
       OS:
         type: string
         description: >
           The operating system targeted by the build.
-
+          
           There must be a corresponding Bundle_$OS.sh script file in ./Scripts
         required: true
-      architecture:
-        type: string
-        description: "CPU architecture targeted by the build."
-        required: true
-
-env:
-  DOTNET_CONFIGURATION: "Release"
-  DOTNET_VERSION: "9.0.x"
-  RELEASE_NAME: "chardonnay"
 
 jobs:
   build:
     name: "${{ inputs.OS }}-${{ inputs.architecture }}"
-    runs-on: ${{ inputs.runs_on }}
+    runs-on: ubuntu-latest
+    env:
+      RUNTIME_ID: "linux-${{ inputs.architecture }}"
     steps:
       - uses: actions/checkout@v5
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v5
+      
+      - uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: ${{ env.DOTNET_VERSION }}
-        env:
-          NUGET_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Get version
-        id: get_version
-        run: |
-          inputVersion="${{ inputs.version_override }}"
-          if [[ "${#inputVersion}" -gt 0 ]]
-          then
-            version="${inputVersion}"
-          else
-            version="$(grep -Eio -m 1 '<Version>.*</Version>' ./Source/AppScaffolding/AppScaffolding.csproj | sed -r 's/<\/?Version>//g')"
-          fi
-          echo "version=${version}" >> "${GITHUB_OUTPUT}"
+          dotnet-version: ${{ inputs.dotnet-version }}
+          dotnet-quality: "ga"
 
       - name: Unit test
-        if: ${{ inputs.run_unit_tests }}
+        if: ${{ inputs.run-unit-tests }}
         working-directory: ./Source
         run: dotnet test
 
@@ -70,63 +53,31 @@ jobs:
         id: publish
         working-directory: ./Source
         run: |
-          if [[ "${{ inputs.OS }}" == "MacOS" ]]
-          then
-            display_os="macOS"
-            RUNTIME_ID="osx-${{ inputs.architecture }}"
-          else
-            display_os="Linux"
-            RUNTIME_ID="linux-${{ inputs.architecture }}"
-          fi
-
-          OUTPUT="bin/Publish/${display_os}-${{ inputs.architecture }}-${{ env.RELEASE_NAME }}"
-
-          echo "display_os=${display_os}" >> $GITHUB_OUTPUT
-          echo "Runtime Identifier: $RUNTIME_ID"
-          echo "Output Directory: $OUTPUT"
-
-          dotnet publish \
-              LibationAvalonia/LibationAvalonia.csproj \
-              --runtime $RUNTIME_ID \
-              --configuration ${{ env.DOTNET_CONFIGURATION }} \
-              --output $OUTPUT \
-              -p:PublishProfile=LibationAvalonia/Properties/PublishProfiles/${display_os}Profile.pubxml
-          dotnet publish \
-              LoadByOS/${display_os}ConfigApp/${display_os}ConfigApp.csproj \
-              --runtime $RUNTIME_ID \
-              --configuration ${{ env.DOTNET_CONFIGURATION }} \
-              --output $OUTPUT \
-              -p:PublishProfile=LoadByOS/Properties/${display_os}ConfigApp/PublishProfiles/${display_os}Profile.pubxml
-          dotnet publish \
-              LibationCli/LibationCli.csproj \
-              --runtime $RUNTIME_ID \
-              --configuration ${{ env.DOTNET_CONFIGURATION }} \
-              --output $OUTPUT \
-              -p:PublishProfile=LibationCli/Properties/PublishProfiles/${display_os}Profile.pubxml
-          dotnet publish \
-              HangoverAvalonia/HangoverAvalonia.csproj \
-              --runtime $RUNTIME_ID \
-              --configuration ${{ env.DOTNET_CONFIGURATION }} \
-              --output $OUTPUT \
-              -p:PublishProfile=HangoverAvalonia/Properties/PublishProfiles/${display_os}Profile.pubxml
+          PUBLISH_ARGS=(
+            '--runtime' '${{ env.RUNTIME_ID }}'
+            '--configuration' 'Release'
+            '--output' '../bin'
+            '-p:PublishProtocol=FileSystem'
+            "-p:PublishReadyToRun=${{ inputs.publish-r2r }}"
+            '-p:SelfContained=true')
+            
+          dotnet publish LibationAvalonia/LibationAvalonia.csproj "${PUBLISH_ARGS[@]}"
+          dotnet publish LoadByOS/LinuxConfigApp/LinuxConfigApp.csproj "${PUBLISH_ARGS[@]}"
+          dotnet publish LibationCli/LibationCli.csproj "${PUBLISH_ARGS[@]}"
+          dotnet publish HangoverAvalonia/HangoverAvalonia.csproj "${PUBLISH_ARGS[@]}"
 
       - name: Build bundle
         id: bundle
-        working-directory: ./Source/bin/Publish/${{ steps.publish.outputs.display_os }}-${{ inputs.architecture }}-${{ env.RELEASE_NAME }}
         run: |
-          BUNDLE_DIR=$(pwd)
-          echo "Bundle dir: ${BUNDLE_DIR}"
-          cd ..
-          SCRIPT=../../../Scripts/Bundle_${{ inputs.OS }}.sh
+          SCRIPT=./Scripts/Bundle_${{ inputs.OS }}.sh
           chmod +rx ${SCRIPT}
-          ${SCRIPT} "${BUNDLE_DIR}" "${{ steps.get_version.outputs.version }}" "${{ inputs.architecture }}"
+          ${SCRIPT} ./bin "${{ inputs.libation-version }}" "${{ inputs.architecture }}"
           artifact=$(ls ./bundle)
           echo "artifact=${artifact}" >> "${GITHUB_OUTPUT}"
 
-      - name: Publish bundle
-        uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v5
         with:
           name: ${{ steps.bundle.outputs.artifact }}
-          path: ./Source/bin/Publish/bundle/${{ steps.bundle.outputs.artifact }}
+          path: ./bundle/${{ steps.bundle.outputs.artifact }}
           if-no-files-found: error
-          retention-days: 7
+          retention-days: ${{ inputs.retention-days }}
diff --git a/.github/workflows/build-mac.yml b/.github/workflows/build-mac.yml
new file mode 100644
index 00000000..75ba2863
--- /dev/null
+++ b/.github/workflows/build-mac.yml
@@ -0,0 +1,99 @@
+# build-mac.yml
+# Reusable workflow that builds the MacOS (x64 and arm64) versions of Libation.
+---
+name: build
+
+on:
+  workflow_call:
+    inputs:
+      libation-version:
+        type: string
+        required: true
+      dotnet-version:
+        type: string
+        required: true
+      run-unit-tests:
+        type: boolean
+      publish-r2r:
+        type: boolean
+      retention-days:
+        type: number
+      architecture:
+        type: string
+        description: "CPU architecture targeted by the build."
+        required: true
+
+env:
+  WAIT_FOR_NOTARIZE: true
+
+jobs:
+  build:
+    name: "macOS-${{ inputs.architecture }}"
+    runs-on: macos-latest
+    env:
+      RUNTIME_ID: "osx-${{ inputs.architecture }}"
+      CAN_SIGN: ${{ secrets.APPLE_TEAM_ID != '' && vars.APPLE_DEV_EMAIL != '' && secrets.APPLE_DEV_PASSWORD != '' }}
+    steps:    
+      - uses: apple-actions/import-codesign-certs@v3
+        if: ${{ env.CAN_SIGN == 'true' }}
+        with: 
+          p12-file-base64: ${{ secrets.DISTRIBUTION_SIGNING_CERT }}
+          p12-password: ${{ secrets.DISTRIBUTION_SIGNING_CERT_PW }}       
+          
+      - uses: actions/checkout@v5
+      
+      - uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: ${{ inputs.dotnet-version }}
+          dotnet-quality: "ga"
+
+      - name: Unit test
+        if: ${{ inputs.run-unit-tests }}
+        working-directory: ./Source
+        run: dotnet test
+
+      - name: Publish
+        id: publish
+        working-directory: ./Source
+        run: |
+          PUBLISH_ARGS=(
+            '--runtime' '${{ env.RUNTIME_ID }}'
+            '--configuration' 'Release'
+            '--output' '../bin'
+            '-p:PublishProtocol=FileSystem'
+            "-p:PublishReadyToRun=${{ inputs.publish-r2r }}"
+            '-p:SelfContained=true')
+          
+          dotnet publish LibationAvalonia/LibationAvalonia.csproj "${PUBLISH_ARGS[@]}"
+          dotnet publish LoadByOS/MacOSConfigApp/MacOSConfigApp.csproj "${PUBLISH_ARGS[@]}"
+          dotnet publish LibationCli/LibationCli.csproj "${PUBLISH_ARGS[@]}"
+          dotnet publish HangoverAvalonia/HangoverAvalonia.csproj "${PUBLISH_ARGS[@]}"
+
+      - name: Build bundle
+        id: bundle
+        run: |
+          SCRIPT=./Scripts/Bundle_MacOS.sh
+          chmod +rx ${SCRIPT}
+          ${SCRIPT} ./bin "${{ inputs.libation-version }}" "${{ inputs.architecture }}" ${{ env.CAN_SIGN }}
+          artifact=$(ls ./bundle)
+          echo "artifact=${artifact}" >> "${GITHUB_OUTPUT}"
+
+      - name: Notarize bundle
+        if: ${{ env.CAN_SIGN == 'true' }}
+        run: |          
+          if [ ${{ env.WAIT_FOR_NOTARIZE }} ]; then
+            WAIT="--wait"
+          fi
+          
+          xcrun notarytool submit ./bundle/${{ steps.bundle.outputs.artifact }} $WAIT --no-progress --apple-id ${{ vars.APPLE_DEV_EMAIL }} --password ${{ secrets.APPLE_DEV_PASSWORD }} --team-id ${{ secrets.APPLE_TEAM_ID }}
+          
+          if [ ${{ env.WAIT_FOR_NOTARIZE }} ]; then
+            xcrun stapler staple "./bundle/${{ steps.bundle.outputs.artifact }}"
+          fi
+
+      - uses: actions/upload-artifact@v5
+        with:
+          name: ${{ steps.bundle.outputs.artifact }}
+          path: ./bundle/${{ steps.bundle.outputs.artifact }}
+          if-no-files-found: error
+          retention-days: ${{ inputs.retention-days }}
diff --git a/.github/workflows/build-windows.yml b/.github/workflows/build-windows.yml
index 725ea5a7..62b3a343 100644
--- a/.github/workflows/build-windows.yml
+++ b/.github/workflows/build-windows.yml
@@ -6,113 +6,77 @@ name: build
 on:
   workflow_call:
     inputs:
-      version_override:
+      libation-version:
         type: string
-        description: "Version number override"
-        required: false
-      run_unit_tests:
-        type: boolean
-        description: "Skip running unit tests"
-        required: false
-        default: true
-      architecture:
-        type: string
-        description: "CPU architecture targeted by the build."
         required: true
-
-env:
-  DOTNET_CONFIGURATION: "Release"
-  DOTNET_VERSION: "9.0.x"
+      dotnet-version:
+        type: string
+        required: true
+      run-unit-tests:
+        type: boolean
+      publish-r2r:
+        type: boolean
+      retention-days:
+        type: number
 
 jobs:
   build:
-    name: "${{ matrix.os }}-${{ matrix.release_name }}-${{ inputs.architecture }}"
+    name: "Windows-${{ matrix.release_name }}-x64"
     runs-on: windows-latest
-    env:
-      OUTPUT_NAME: "${{ matrix.os }}-${{ matrix.release_name }}-${{ inputs.architecture }}"
-      RUNTIME_ID: "win-${{ inputs.architecture }}"
     strategy:
       matrix:
-        os: [Windows]
         ui: [Avalonia]
         release_name: [chardonnay]
         include:
-          - os: Windows
-            ui: WinForms
+          - ui: WinForms
             release_name: classic
             prefix: Classic-
     steps:
       - uses: actions/checkout@v5
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v5
+      
+      - uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: ${{ env.DOTNET_VERSION }}
-        env:
-          NUGET_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Get version
-        id: get_version
-        run: |
-          if ("${{ inputs.version_override }}".length -gt 0) {
-            $version = "${{ inputs.version_override }}"
-          } else {
-            $version = (Select-Xml -Path "./Source/AppScaffolding/AppScaffolding.csproj" -XPath "/Project/PropertyGroup/Version").Node.InnerXML.Trim()
-          }
-          "version=$version" >> $env:GITHUB_OUTPUT
+          dotnet-version: ${{ inputs.dotnet-version }}
+          dotnet-quality: "ga"
 
       - name: Unit test
-        if: ${{ inputs.run_unit_tests }}
+        if: ${{ inputs.run-unit-tests }}
         working-directory: ./Source
         run: dotnet test
-
+        
       - name: Publish
         working-directory: ./Source
         run: |
-          dotnet publish `
-              Libation${{ matrix.ui }}/Libation${{ matrix.ui }}.csproj `
-              --runtime ${{ env.RUNTIME_ID }} `
-              --configuration ${{ env.DOTNET_CONFIGURATION }} `
-              --output bin/Publish/${{ env.OUTPUT_NAME }} `
-              -p:PublishProfile=Libation${{ matrix.ui }}/Properties/PublishProfiles/${{ matrix.os }}Profile.pubxml
-          dotnet publish `
-              LoadByOS/${{ matrix.os }}ConfigApp/${{ matrix.os }}ConfigApp.csproj `
-              --runtime ${{ env.RUNTIME_ID }} `
-              --configuration ${{ env.DOTNET_CONFIGURATION }} `
-              --output bin/Publish/${{ env.OUTPUT_NAME }} `
-              -p:PublishProfile=LoadByOS/${{ matrix.os }}ConfigApp/PublishProfiles/${{ matrix.os }}Profile.pubxml
-          dotnet publish `
-              LibationCli/LibationCli.csproj `
-              --runtime ${{ env.RUNTIME_ID }} `
-              --configuration ${{ env.DOTNET_CONFIGURATION }} `
-              --output bin/Publish/${{ env.OUTPUT_NAME }} `
-              -p:DefineConstants="${{ matrix.release_name }}" `
-              -p:PublishProfile=LibationCli/Properties/PublishProfiles/${{ matrix.os }}Profile.pubxml
-          dotnet publish `
-              Hangover${{ matrix.ui }}/Hangover${{ matrix.ui }}.csproj `
-              --runtime ${{ env.RUNTIME_ID }} `
-              --configuration ${{ env.DOTNET_CONFIGURATION }} `
-              --output bin/Publish/${{ env.OUTPUT_NAME }} `
-              -p:PublishProfile=Hangover${{ matrix.ui }}/Properties/PublishProfiles/${{ matrix.os }}Profile.pubxml
+          $PUBLISH_ARGS=@(
+            "--runtime", "win-x64",
+            "--configuration", "Release",
+            "--output", "../bin",
+            "-p:PublishProtocol=FileSystem",
+            "-p:PublishReadyToRun=${{ inputs.publish-r2r }}",
+            "-p:SelfContained=true")            
+          
+          dotnet publish "Libation${{ matrix.ui }}/Libation${{ matrix.ui }}.csproj" $PUBLISH_ARGS
+          dotnet publish "LoadByOS/WindowsConfigApp/WindowsConfigApp.csproj" $PUBLISH_ARGS
+          dotnet publish "LibationCli/LibationCli.csproj" $PUBLISH_ARGS
+          dotnet publish "Hangover${{ matrix.ui }}/Hangover${{ matrix.ui }}.csproj" $PUBLISH_ARGS
 
       - name: Zip artifact
         id: zip
-        working-directory: ./Source/bin/Publish
+        working-directory: ./bin
         run: |
-          $bin_dir = "${{ env.OUTPUT_NAME }}\"
           $delfiles = @(
             "WindowsConfigApp.exe",
             "WindowsConfigApp.runtimeconfig.json",
-            "WindowsConfigApp.deps.json"
-            )
-          foreach ($file in $delfiles){ if (test-path $bin_dir$file){ Remove-Item $bin_dir$file } }
-          $artifact="${{ matrix.prefix }}Libation.${{ steps.get_version.outputs.version }}-" + "${{ matrix.os }}".ToLower() + "-${{ matrix.release_name }}-${{ inputs.architecture }}"
+            "WindowsConfigApp.deps.json")
+          
+          foreach ($file in $delfiles){ if (test-path $file){ Remove-Item $file } }
+          $artifact="${{ matrix.prefix }}Libation.${{ inputs.libation-version }}-windows-${{ matrix.release_name }}-x64.zip"
           "artifact=$artifact" >> $env:GITHUB_OUTPUT
-          Compress-Archive -Path "${bin_dir}*" -DestinationPath "$artifact.zip"
+          Compress-Archive -Path * -DestinationPath "$artifact"
 
-      - name: Publish artifact
-        uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v5
         with:
-          name: ${{ steps.zip.outputs.artifact }}.zip
-          path: ./Source/bin/Publish/${{ steps.zip.outputs.artifact }}.zip
+          name: ${{ steps.zip.outputs.artifact }}
+          path: ./bin/${{ steps.zip.outputs.artifact }}
           if-no-files-found: error
-          retention-days: 7
+          retention-days: ${{ inputs.retention-days }}
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 341f8033..9880c23d 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -6,26 +6,47 @@ name: build
 on:
   workflow_call:
     inputs:
-      version_override:
+      libation-version:
         type: string
-        description: "Version number override"
-        required: false
-      run_unit_tests:
+        description: "Libation version number"
+        required: true
+      dotnet-version:
+        type: string
+        default: "9.x"
+        description: ".NET version to target"
+      run-unit-tests:
         type: boolean
-        description: "Skip running unit tests"
-        required: false
-        default: true
+        description: "Whether to run unit tests prior to publishing."
+      publish-r2r:
+        type: boolean
+        description: "Whether to publish assemblies as ReadyToRun."
+      retention-days:
+        type: number
+        description: "Number of days the artifacts are to be retained."
 
-jobs:
+jobs:    
   windows:
-    strategy:
-      matrix:
-        architecture: [x64]
     uses: ./.github/workflows/build-windows.yml
     with:
-      version_override: ${{ inputs.version_override }}
-      run_unit_tests: ${{ inputs.run_unit_tests }}
+      libation-version: ${{ inputs.libation-version }}
+      dotnet-version: ${{ inputs.dotnet-version }}
+      run-unit-tests: ${{ inputs.run-unit-tests }}
+      publish-r2r: ${{ inputs.publish-r2r }}
+      retention-days: ${{ inputs.retention-days }}
+      
+  macOS:
+    strategy:
+      matrix:
+        architecture: [x64, arm64]
+    uses: ./.github/workflows/build-mac.yml
+    with:
+      libation-version: ${{ inputs.libation-version }}
+      dotnet-version: ${{ inputs.dotnet-version }}
+      run-unit-tests: ${{ inputs.run-unit-tests }}
+      publish-r2r: ${{ inputs.publish-r2r }}
+      retention-days: ${{ inputs.retention-days }}
       architecture: ${{ matrix.architecture }}
+    secrets: inherit
 
   linux:
     strategy:
@@ -34,20 +55,11 @@ jobs:
         architecture: [x64, arm64]
     uses: ./.github/workflows/build-linux.yml
     with:
-      version_override: ${{ inputs.version_override }}
-      runs_on: ubuntu-latest
+      libation-version: ${{ inputs.libation-version }}
+      dotnet-version: ${{ inputs.dotnet-version }}
+      run-unit-tests: ${{ inputs.run-unit-tests }}
+      publish-r2r: ${{ inputs.publish-r2r }}
+      retention-days: ${{ inputs.retention-days }}
+      architecture: ${{ matrix.architecture }}
       OS: ${{ matrix.OS }}
-      architecture: ${{ matrix.architecture }}
-      run_unit_tests: ${{ inputs.run_unit_tests }}
 
-  macos:
-    strategy:
-      matrix:
-        architecture: [x64, arm64]
-    uses: ./.github/workflows/build-linux.yml
-    with:
-      version_override: ${{ inputs.version_override }}
-      runs_on: macos-latest
-      OS: MacOS
-      architecture: ${{ matrix.architecture }}
-      run_unit_tests: ${{ inputs.run_unit_tests }}
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 244b6e75..867f56e3 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -8,7 +8,7 @@ on:
       - "v*"
 jobs:
   prerelease:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-slim
     outputs:
       version: ${{ steps.get_version.outputs.version }}
     steps:
@@ -31,9 +31,10 @@ jobs:
   build:
     needs: [prerelease]
     uses: ./.github/workflows/build.yml
+    secrets: inherit
     with:
-      version_override: ${{ needs.prerelease.outputs.version }}
-      run_unit_tests: false
+      libation-version: ${{ needs.prerelease.outputs.version }}
+      publish-r2r: true
 
   release:
     needs: [prerelease, build]
diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index 27abc275..89877043 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -10,12 +10,30 @@ on:
     branches: [master]
 
 jobs:
+  get_version:
+    runs-on: ubuntu-slim
+    outputs:
+      version: ${{ steps.get_version.outputs.version }}
+    steps:
+      - name: Get version
+        id: get_version
+        run: |
+          wget "https://raw.githubusercontent.com/${{ github.repository }}/${{ github.sha }}/Source/AppScaffolding/AppScaffolding.csproj"
+          version="$(grep -Eio -m 1 '<Version>.*</Version>' ./AppScaffolding.csproj | sed -r 's/<\/?Version>//g')"
+          echo "version=${version}" >> "${GITHUB_OUTPUT}"
   build:
+    needs: [get_version]
     uses: ./.github/workflows/build.yml
+    with:
+      libation-version: ${{ needs.get_version.outputs.version }}
+      retention-days: 14
+      run-unit-tests: true
+      
   docker:
+    needs: [get_version]
     uses: ./.github/workflows/docker.yml
     with:
-      version: ${GITHUB_SHA}
+      version: ${{ needs.get_version.outputs.version }}
       release: false
     secrets:
       docker_username: ${{ secrets.DOCKERHUB_USERNAME }}
diff --git a/Scripts/Bundle_Debian.sh b/Scripts/Bundle_Debian.sh
index b69eb76f..2a5d5034 100644
--- a/Scripts/Bundle_Debian.sh
+++ b/Scripts/Bundle_Debian.sh
@@ -28,14 +28,6 @@ then
   exit
 fi
 
-contains() { case "$1" in *"$2"*) true ;; *) false ;; esac }
-
-if ! contains "$BIN_DIR" "$ARCH"
-then
-  echo "This script must be called with a Libation binaries for ${ARCH}."
-  exit
-fi
-
 ARCH=$(echo $ARCH | sed 's/x64/amd64/')
 
 DEB_DIR=./deb
diff --git a/Scripts/Bundle_MacOS.sh b/Scripts/Bundle_MacOS.sh
index 7b5f6a0b..09bd9d03 100644
--- a/Scripts/Bundle_MacOS.sh
+++ b/Scripts/Bundle_MacOS.sh
@@ -3,6 +3,7 @@
 BIN_DIR=$1; shift
 VERSION=$1; shift
 ARCH=$1; shift
+SIGN_WITH_KEY=$1; shift
 
 if [ -z "$BIN_DIR" ]
 then
@@ -28,12 +29,9 @@ then
   exit
 fi
 
-contains() { case "$1" in *"$2"*) true ;; *) false ;; esac }
-
-if ! contains "$BIN_DIR" $ARCH
+if [ "$SIGN_WITH_KEY" != "true" ]
 then
-  echo "This script must be called with a Libation binaries for ${ARCH}."
-  exit
+  echo "[WARNING] App will fail Gatekeeper verification without valid Apple Team information."
 fi
 
 BUNDLE=./Libation.app
@@ -74,6 +72,16 @@ mv $BUNDLE_MACOS/libation.icns $BUNDLE_RESOURCES/libation.icns
 echo "Moving Info.plist file..."
 mv $BUNDLE_MACOS/Info.plist $BUNDLE_CONTENTS/Info.plist
 
+echo "Moving Libation_DS_Store file..."
+mv $BUNDLE_MACOS/Libation_DS_Store ./Libation_DS_Store
+
+echo "Moving background.png file..."
+mv $BUNDLE_MACOS/background.png ./background.png
+
+echo "Moving background.png file..."
+mv $BUNDLE_MACOS/Libation.entitlements ./Libation.entitlements
+ENTITLEMENTS="./Libation.entitlements"
+
 PLIST_ARCH=$(echo $ARCH | sed 's/x64/x86_64/')
 echo "Set LSArchitecturePriority to $PLIST_ARCH"
 sed -i -e "s/ARCHITECTURE_STRING/$PLIST_ARCH/" $BUNDLE_CONTENTS/Info.plist
@@ -81,27 +89,40 @@ sed -i -e "s/ARCHITECTURE_STRING/$PLIST_ARCH/" $BUNDLE_CONTENTS/Info.plist
 echo "Set CFBundleVersion to $VERSION"
 sed -i -e "s/VERSION_STRING/$VERSION/" $BUNDLE_CONTENTS/Info.plist
 
-
 delfiles=('MacOSConfigApp' 'MacOSConfigApp.deps.json' 'MacOSConfigApp.runtimeconfig.json')
-
 for n in "${delfiles[@]}"
 do
   echo "Deleting $n"
   rm $BUNDLE_MACOS/$n
 done
 
-APP_FILE=Libation.${VERSION}-macOS-chardonnay-${ARCH}.tgz
+DMG_FILE="Libation.${VERSION}-macOS-chardonnay-${ARCH}.dmg"
 
-echo "Signing executables in: $BUNDLE"
-codesign --force --deep -s - $BUNDLE
+all_identities=$(security find-identity -v -p codesigning)
+identity=$(echo ${all_identities} | sed -n 's/.*"\(.*\)".*/\1/p')
 
-echo "Creating app bundle: $APP_FILE"
-tar -czvf $APP_FILE $BUNDLE
+if [ "$SIGN_WITH_KEY" == "true" ]; then
+  echo "Signing executables in: $BUNDLE"
+  codesign --force --deep --timestamp --options=runtime --entitlements "$ENTITLEMENTS" --sign "${identity}" "$BUNDLE"
+  codesign --verify --verbose "$BUNDLE"
+else
+  echo "Signing with empty key: $BUNDLE"
+  codesign --force --deep -s - $BUNDLE
+fi
 
-mkdir bundle
-echo "moving to ./bundle/$APP_FILE"
-mv $APP_FILE ./bundle/$APP_FILE
+echo "Creating app disk image: $DMG_FILE"
+mkdir Libation
+mv $BUNDLE ./Libation/$BUNDLE
+mv Libation_DS_Store Libation/.DS_Store
+mkdir Libation/.background
+mv background.png Libation/.background/
+ln -s /Applications "./Libation/ "
+mkdir ./bundle
+hdiutil create -srcFolder ./Libation -o "./bundle/$DMG_FILE"
 
-rm -r $BUNDLE
+if [ "$SIGN_WITH_KEY" == "true" ]; then
+  echo "Signing $DMG_FILE"
+  codesign --deep --sign "${identity}" "./bundle/$DMG_FILE"
+fi
 
 echo "Done!"
diff --git a/Scripts/Bundle_Redhat.sh b/Scripts/Bundle_Redhat.sh
index 05d27ac6..e79009f9 100644
--- a/Scripts/Bundle_Redhat.sh
+++ b/Scripts/Bundle_Redhat.sh
@@ -28,14 +28,6 @@ then
   exit
 fi
 
-contains() { case "$1" in *"$2"*) true ;; *) false ;; esac }
-
-if ! contains "$BIN_DIR" "$ARCH"
-then
-  echo "This script must be called with a Libation binaries for ${ARCH}."
-  exit
-fi
-
 BASEDIR=$(pwd)
 
 delfiles=('LinuxConfigApp' 'LinuxConfigApp.deps.json' 'LinuxConfigApp.runtimeconfig.json')
diff --git a/Source/LoadByOS/MacOSConfigApp/Info.plist b/Source/LoadByOS/MacOSConfigApp/Info.plist
index b9d85062..9452340a 100644
--- a/Source/LoadByOS/MacOSConfigApp/Info.plist
+++ b/Source/LoadByOS/MacOSConfigApp/Info.plist
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
-
 <dict>
 	<key>CFBundleExecutable</key>
 	<string>Libation</string>
@@ -19,17 +18,5 @@
 	<string>libation.icns</string>
 	<key>CFBundleVersion</key>
 	<string>VERSION_STRING</string>
-	<key>com.apple.security.app-sandbox</key>
-	<false/>	
-	<key>com.apple.security.cs.allow-jit</key>
-	<true/>
-	<key>com.apple.security.cs.allow-unsigned-executable-memory</key>
-	<true/>
-	<key>com.apple.security.cs.disable-library-validation</key>
-	<true/>
-	<key>com.apple.security.cs.disable-executable-page-protection</key>
-	<true/>
-	<key>com.apple.security.automation.apple-events</key>
-	<true/>
 </dict>
 </plist>
\ No newline at end of file
diff --git a/Source/LoadByOS/MacOSConfigApp/Libation.entitlements b/Source/LoadByOS/MacOSConfigApp/Libation.entitlements
new file mode 100644
index 00000000..61d4c457
--- /dev/null
+++ b/Source/LoadByOS/MacOSConfigApp/Libation.entitlements
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.app-sandbox</key>
+  <false/>
+  <key>com.apple.security.cs.allow-jit</key>
+  <true/>
+  <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+  <true/>
+  <key>com.apple.security.cs.disable-library-validation</key>
+  <true/>
+  <key>com.apple.security.cs.disable-executable-page-protection</key>
+  <true/>
+  <key>com.apple.security.cs.allow-dyld-environment-variables</key>
+  <true/>
+  <key>com.apple.security.automation.apple-events</key>
+  <true/>
+</dict>
+</plist>
diff --git a/Source/LoadByOS/MacOSConfigApp/Libation_DS_Store b/Source/LoadByOS/MacOSConfigApp/Libation_DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..8134a5e7328c75e185dc4c9776f56524506fb3a2
GIT binary patch
literal 14340
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

literal 0
HcmV?d00001

diff --git a/Source/LoadByOS/MacOSConfigApp/MacOSConfigApp.csproj b/Source/LoadByOS/MacOSConfigApp/MacOSConfigApp.csproj
index 063474a9..e4dca926 100644
--- a/Source/LoadByOS/MacOSConfigApp/MacOSConfigApp.csproj
+++ b/Source/LoadByOS/MacOSConfigApp/MacOSConfigApp.csproj
@@ -30,15 +30,27 @@
   </ItemGroup>
 
   <ItemGroup>
+    <None Update="background.png">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
     <None Update="fileicon">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
     </None>
     <None Update="Info.plist">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
     </None>
+    <None Update="Libation.entitlements">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
+    <None Update="Libation.entitlements.txt">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
     <None Update="libation.icns">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
     </None>
+    <None Update="Libation_DS_Store">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
   </ItemGroup>
 
 </Project>
\ No newline at end of file
diff --git a/Source/LoadByOS/MacOSConfigApp/background.png b/Source/LoadByOS/MacOSConfigApp/background.png
new file mode 100644
index 0000000000000000000000000000000000000000..c74f1ae57b9c2ee85f74c5939ed4b927281371f4
GIT binary patch
literal 12463
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
LRj%aeoA>_<8yuhB

literal 0
HcmV?d00001


From f29c19beb84eec72215d7a14dbbf205453ee175e Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Thu, 13 Nov 2025 23:03:11 -0700
Subject: [PATCH 08/18] Update .gitignore

---
 .gitignore | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index ba279ef4..41375dd9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -370,4 +370,10 @@ FodyWeavers.xsd
 
 /__TODO.txt
 /DataLayer/LibationContext.db
-*/bin-Avalonia
\ No newline at end of file
+*/bin-Avalonia
+
+# macOS Directory Info
+.DS_Store
+
+# JetBrains Rider Settings
+**/.idea/
\ No newline at end of file

From d6b232f342a8d675ae68abecaed54c54f41127c2 Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Thu, 13 Nov 2025 23:12:57 -0700
Subject: [PATCH 09/18] Update Logging and Error Handling

- Add Configuration.LoggingEnabled property which gets set as soon as Serilog is configured
- Add error handling to InteropFactory
---
 Source/LibationAvalonia/App.axaml.cs           |  1 -
 Source/LibationAvalonia/Program.cs             |  5 ++---
 .../Configuration.Logging.cs                   |  5 ++++-
 Source/LibationFileManager/InteropFactory.cs   | 18 +++++++++++++-----
 4 files changed, 19 insertions(+), 10 deletions(-)

diff --git a/Source/LibationAvalonia/App.axaml.cs b/Source/LibationAvalonia/App.axaml.cs
index b2a7281b..db969cf4 100644
--- a/Source/LibationAvalonia/App.axaml.cs
+++ b/Source/LibationAvalonia/App.axaml.cs
@@ -222,7 +222,6 @@ public class App : Application
 
 		// logging is init'd here
 		AppScaffolding.LibationScaffolding.RunPostMigrationScaffolding(AppScaffolding.Variety.Chardonnay, config);
-		Program.LoggingEnabled = true;
 	}
 
 	private static void ShowMainWindow(IClassicDesktopStyleApplicationLifetime desktop)
diff --git a/Source/LibationAvalonia/Program.cs b/Source/LibationAvalonia/Program.cs
index a5ad6097..f9b84f6d 100644
--- a/Source/LibationAvalonia/Program.cs
+++ b/Source/LibationAvalonia/Program.cs
@@ -12,6 +12,7 @@ using LibationAvalonia.Dialogs;
 using Avalonia.Threading;
 using FileManager;
 using System.Linq;
+using System.Reflection;
 
 #nullable enable
 namespace LibationAvalonia
@@ -19,7 +20,6 @@ namespace LibationAvalonia
 	static class Program
 	{
 		private static System.Threading.Lock SetupLock { get; } = new();
-		internal static bool LoggingEnabled { get; set; }
 		[STAThread]
 		static void Main(string[] args)
 		{
@@ -56,7 +56,6 @@ namespace LibationAvalonia
 					// most migrations go in here
 					LibationScaffolding.RunPostConfigMigrations(config);
 					LibationScaffolding.RunPostMigrationScaffolding(Variety.Chardonnay, config);
-					LoggingEnabled = true;
 
 					//Start loading the library before loading the main form
 					App.LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
@@ -106,7 +105,7 @@ namespace LibationAvalonia
 			try
 			{
 				//Try to log the error message before displaying the crash dialog
-				if (LoggingEnabled)
+				if (Configuration.Instance.LoggingEnabled)
 					Serilog.Log.Logger.Error(exception, "CRASH");
 				else
 					LogErrorWithoutSerilog(exception);
diff --git a/Source/LibationFileManager/Configuration.Logging.cs b/Source/LibationFileManager/Configuration.Logging.cs
index 70fdbc0b..ffbf9f2f 100644
--- a/Source/LibationFileManager/Configuration.Logging.cs
+++ b/Source/LibationFileManager/Configuration.Logging.cs
@@ -15,6 +15,8 @@ namespace LibationFileManager
     {
         private IConfigurationRoot? configuration;
 
+        public bool LoggingEnabled { get; private set; }
+
         public void ConfigureLogging()
         {
             //pass explicit assemblies to the ConfigurationReaderOptions
@@ -40,7 +42,8 @@ namespace LibationFileManager
 				 .Destructure.ByTransforming<LongPath>(lp => lp.Path)
 				 .Destructure.With<LogFileFilter>()
                  .CreateLogger();
-		}
+            LoggingEnabled = true;
+        }
 
 		[Description("The importance of a log event")]
         public LogEventLevel LogLevel
diff --git a/Source/LibationFileManager/InteropFactory.cs b/Source/LibationFileManager/InteropFactory.cs
index c3198944..043535d4 100644
--- a/Source/LibationFileManager/InteropFactory.cs
+++ b/Source/LibationFileManager/InteropFactory.cs
@@ -65,11 +65,19 @@ namespace LibationFileManager
 
             AppDomain.CurrentDomain.AssemblyResolve += CurrentDomain_AssemblyResolve;
 
-            var configAppAssembly = Assembly.LoadFrom(configApp);
-            var type = typeof(IInteropFunctions);
-            InteropFunctionsType = configAppAssembly
-                .GetTypes()
-                .FirstOrDefault(type.IsAssignableFrom);
+            try
+            {
+                var configAppAssembly = Assembly.LoadFrom(configApp);
+                var type = typeof(IInteropFunctions);
+                InteropFunctionsType = configAppAssembly
+                    .GetTypes()
+                    .FirstOrDefault(type.IsAssignableFrom);
+            }
+            catch (Exception e)
+            {
+                //None of the interop functions are strictly necessary for Libation to run.
+                Serilog.Log.Logger.Error(e, "Unable to load types from assembly {@configApp}", configApp);
+            }
         }
         private static string? getOSConfigApp()
         {

From 2213f5c86a7218c576b9b25bae36188f40481b97 Mon Sep 17 00:00:00 2001
From: Mbucari <37587114+Mbucari@users.noreply.github.com>
Date: Thu, 13 Nov 2025 23:15:29 -0700
Subject: [PATCH 10/18] Change msaOS updater to get DMGs

This will break _Automatic_ updates for existing mac users (although I'm not sure it worked all that well to begin with. However, the update notification dialog has had a link to download the bundle manually for a long time now. Old users will still be notified of the new release and be given a direct link to download it.
---
 .releaseindex.json                             |  4 ++--
 Source/LoadByOS/MacOSConfigApp/MacOSInterop.cs | 13 ++-----------
 2 files changed, 4 insertions(+), 13 deletions(-)

diff --git a/.releaseindex.json b/.releaseindex.json
index 7ae58e51..a709e453 100644
--- a/.releaseindex.json
+++ b/.releaseindex.json
@@ -3,8 +3,8 @@
   "WindowsAvalonia":         "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-win(?:dows)?-chardonnay-x64\\.zip",
   "LinuxAvalonia":           "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-amd64\\.deb",
   "LinuxAvalonia_RPM":       "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-amd64\\.rpm",
-  "MacOSAvalonia":           "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-macOS-chardonnay-x64\\.tgz",
+  "MacOSAvalonia":           "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-macOS-chardonnay-x64\\.dmg",
   "LinuxAvalonia_Arm64":     "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-arm64\\.deb",
   "LinuxAvalonia_Arm64_RPM": "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-arm64\\.rpm",
-  "MacOSAvalonia_Arm64":     "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-macOS-chardonnay-arm64\\.tgz"
+  "MacOSAvalonia_Arm64":     "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-macOS-chardonnay-arm64\\.dmg"
 }
diff --git a/Source/LoadByOS/MacOSConfigApp/MacOSInterop.cs b/Source/LoadByOS/MacOSConfigApp/MacOSInterop.cs
index b9ecc1a1..8ab9d43f 100644
--- a/Source/LoadByOS/MacOSConfigApp/MacOSInterop.cs
+++ b/Source/LoadByOS/MacOSConfigApp/MacOSInterop.cs
@@ -29,17 +29,8 @@ namespace MacOSConfigApp
 		{
 			Serilog.Log.Information($"Extracting upgrade bundle to {AppPath}");
 
-			//tar wil overwrite existing without elevated privileges
-			Process.Start("tar", $"-xf {upgradeBundle.SurroundWithQuotes()} -C \"/Applications\"").WaitForExit();
-			
-			//For now, it seems like this step is unnecessary. We can overwrite and
-			//run Libation without needing to re-add the exception. This is insurance.
-			RunAsRoot(null, $"""
-sudo spctl --master-disable
-sudo spctl --add --label 'Libation' {AppPath}
-open {AppPath}
-sudo spctl --master-enable
-""");
+			//Upgrade bundle is a DMG
+			Process.Start("open", upgradeBundle.SurroundWithQuotes())?.WaitForExit();
 		}
 
 		//Using osascript -e '[script]' works from the terminal, but I haven't figured

From d1ce9d5a83f6454a8336fe4f3accfca282cac30e Mon Sep 17 00:00:00 2001
From: Michael Bucari-Tovo <mbucari1@gmail.com>
Date: Fri, 14 Nov 2025 10:04:14 -0700
Subject: [PATCH 11/18] Update Mac Workflow

- Add new repo variables
  - `SIGN_MAC_APP_ON_VALIDATE` will force sign/notarize on the validate workflow (normally only done for releases)
  - `WAIT_FOR_NOTARIZE` Causes the build-mac workflow to wait for apple to notarize the bundle so that it can be stapled. This is usually fast (1-2 mis), but can be very long and may cause workflow runners to time out.
---
 .github/workflows/build-mac.yml | 25 +++++++++++++++----------
 .github/workflows/build.yml     |  4 ++++
 .github/workflows/release.yml   |  1 +
 .github/workflows/validate.yml  |  1 +
 Scripts/Bundle_MacOS.sh         | 10 +++++++---
 5 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/build-mac.yml b/.github/workflows/build-mac.yml
index 75ba2863..7681b26d 100644
--- a/.github/workflows/build-mac.yml
+++ b/.github/workflows/build-mac.yml
@@ -18,24 +18,24 @@ on:
         type: boolean
       retention-days:
         type: number
+      sign-app:
+        type: boolean
+        description: "Wheather to sign an notorize the app bundle and dmg."
       architecture:
         type: string
         description: "CPU architecture targeted by the build."
         required: true
 
-env:
-  WAIT_FOR_NOTARIZE: true
-
 jobs:
   build:
     name: "macOS-${{ inputs.architecture }}"
     runs-on: macos-latest
     env:
       RUNTIME_ID: "osx-${{ inputs.architecture }}"
-      CAN_SIGN: ${{ secrets.APPLE_TEAM_ID != '' && vars.APPLE_DEV_EMAIL != '' && secrets.APPLE_DEV_PASSWORD != '' }}
+      WAIT_FOR_NOTARIZE: ${{ vars.WAIT_FOR_NOTARIZE == 'true' }}
     steps:    
       - uses: apple-actions/import-codesign-certs@v3
-        if: ${{ env.CAN_SIGN == 'true' }}
+        if: ${{ inputs.sign-app }}
         with: 
           p12-file-base64: ${{ secrets.DISTRIBUTION_SIGNING_CERT }}
           p12-password: ${{ secrets.DISTRIBUTION_SIGNING_CERT_PW }}       
@@ -74,20 +74,25 @@ jobs:
         run: |
           SCRIPT=./Scripts/Bundle_MacOS.sh
           chmod +rx ${SCRIPT}
-          ${SCRIPT} ./bin "${{ inputs.libation-version }}" "${{ inputs.architecture }}" ${{ env.CAN_SIGN }}
+          ${SCRIPT} ./bin "${{ inputs.libation-version }}" "${{ inputs.architecture }}" "${{ inputs.sign-app }}"
           artifact=$(ls ./bundle)
           echo "artifact=${artifact}" >> "${GITHUB_OUTPUT}"
 
       - name: Notarize bundle
-        if: ${{ env.CAN_SIGN == 'true' }}
+        if: ${{ inputs.sign-app }}
         run: |          
-          if [ ${{ env.WAIT_FOR_NOTARIZE }} ]; then
+          if [ ${{ vars.WAIT_FOR_NOTARIZE == 'true' }} ]; then
             WAIT="--wait"
           fi
+          echo "::debug::Submitting the disk image for notarization"
+          RESPONSE=$(xcrun notarytool submit ./bundle/${{ steps.bundle.outputs.artifact }} $WAIT --no-progress --apple-id ${{ vars.APPLE_DEV_EMAIL }} --password ${{ secrets.APPLE_DEV_PASSWORD }} --team-id ${{ secrets.APPLE_TEAM_ID }} 2>&1)
+          SUBMISSION_ID=$(echo "$RESPONSE" | awk '/id: / { print $2;exit; }')
           
-          xcrun notarytool submit ./bundle/${{ steps.bundle.outputs.artifact }} $WAIT --no-progress --apple-id ${{ vars.APPLE_DEV_EMAIL }} --password ${{ secrets.APPLE_DEV_PASSWORD }} --team-id ${{ secrets.APPLE_TEAM_ID }}
+          echo "$RESPONSE"
+          echo "::notice::Noraty Submission Id: $SUBMISSION_ID"
           
-          if [ ${{ env.WAIT_FOR_NOTARIZE }} ]; then
+          if [ ${{ vars.WAIT_FOR_NOTARIZE == 'true' }} ]; then
+            echo "::debug::Stapling the notarization ticket to the disk image"
             xcrun stapler staple "./bundle/${{ steps.bundle.outputs.artifact }}"
           fi
 
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 9880c23d..fe4a90cc 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -20,6 +20,9 @@ on:
       publish-r2r:
         type: boolean
         description: "Whether to publish assemblies as ReadyToRun."
+      release:
+        type: boolean
+        description: "Whether this workflow is being called as a release"
       retention-days:
         type: number
         description: "Number of days the artifacts are to be retained."
@@ -46,6 +49,7 @@ jobs:
       publish-r2r: ${{ inputs.publish-r2r }}
       retention-days: ${{ inputs.retention-days }}
       architecture: ${{ matrix.architecture }}
+      sign-app: ${{ inputs.release || vars.SIGN_MAC_APP_ON_VALIDATE == 'true' }}
     secrets: inherit
 
   linux:
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 867f56e3..0a575e2e 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -35,6 +35,7 @@ jobs:
     with:
       libation-version: ${{ needs.prerelease.outputs.version }}
       publish-r2r: true
+      release: true
 
   release:
     needs: [prerelease, build]
diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index 89877043..892b2680 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -24,6 +24,7 @@ jobs:
   build:
     needs: [get_version]
     uses: ./.github/workflows/build.yml
+    secrets: inherit
     with:
       libation-version: ${{ needs.get_version.outputs.version }}
       retention-days: 14
diff --git a/Scripts/Bundle_MacOS.sh b/Scripts/Bundle_MacOS.sh
index 09bd9d03..d023a10b 100644
--- a/Scripts/Bundle_MacOS.sh
+++ b/Scripts/Bundle_MacOS.sh
@@ -31,7 +31,7 @@ fi
 
 if [ "$SIGN_WITH_KEY" != "true" ]
 then
-  echo "[WARNING] App will fail Gatekeeper verification without valid Apple Team information."
+  echo "::warning:: App will fail Gatekeeper verification without valid Apple Team information."
 fi
 
 BUNDLE=./Libation.app
@@ -80,7 +80,6 @@ mv $BUNDLE_MACOS/background.png ./background.png
 
 echo "Moving background.png file..."
 mv $BUNDLE_MACOS/Libation.entitlements ./Libation.entitlements
-ENTITLEMENTS="./Libation.entitlements"
 
 PLIST_ARCH=$(echo $ARCH | sed 's/x64/x86_64/')
 echo "Set LSArchitecturePriority to $PLIST_ARCH"
@@ -103,7 +102,7 @@ identity=$(echo ${all_identities} | sed -n 's/.*"\(.*\)".*/\1/p')
 
 if [ "$SIGN_WITH_KEY" == "true" ]; then
   echo "Signing executables in: $BUNDLE"
-  codesign --force --deep --timestamp --options=runtime --entitlements "$ENTITLEMENTS" --sign "${identity}" "$BUNDLE"
+  codesign --force --deep --timestamp --options=runtime --entitlements "./Libation.entitlements" --sign "${identity}" "$BUNDLE"
   codesign --verify --verbose "$BUNDLE"
 else
   echo "Signing with empty key: $BUNDLE"
@@ -119,6 +118,11 @@ mv background.png Libation/.background/
 ln -s /Applications "./Libation/ "
 mkdir ./bundle
 hdiutil create -srcFolder ./Libation -o "./bundle/$DMG_FILE"
+# Create a .DS_Store by:
+#  - mounting an existing image in shadow mode (hdiutil attach Libation.dmg -shadow junk.dmg)
+#  - Open the folder and edit it to your liking.
+#  - Copy the .DS_Store from the directory and save it to Libation_DS_Store
+
 
 if [ "$SIGN_WITH_KEY" == "true" ]; then
   echo "Signing $DMG_FILE"

From e05dcd6f54a34c6f23611c6a8b0c5dd562d0c524 Mon Sep 17 00:00:00 2001
From: Michael Bucari-Tovo <mbucari1@gmail.com>
Date: Fri, 14 Nov 2025 13:35:36 -0700
Subject: [PATCH 12/18] Don't overwrite LibationFiles setting in
 appsettings.json

---
 Source/LibationAvalonia/App.axaml.cs                      | 7 ++++---
 .../LibationFileManager/Configuration.KnownDirectories.cs | 8 ++++++--
 Source/LibationWinForms/Program.cs                        | 5 +++--
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/Source/LibationAvalonia/App.axaml.cs b/Source/LibationAvalonia/App.axaml.cs
index db969cf4..8eedfbb4 100644
--- a/Source/LibationAvalonia/App.axaml.cs
+++ b/Source/LibationAvalonia/App.axaml.cs
@@ -58,9 +58,11 @@ public class App : Application
 			{
 				string defaultLibationFilesDir = Configuration.DefaultLibationFilesDirectory;
 
-				// check for existing settings in default location
+				// check for existing settings in default location.
+				// First check if file exists so that, if it doesn't, we don't
+				// overwrite user's LibationFiles setting in appsettings.json
 				string defaultSettingsFile = Path.Combine(defaultLibationFilesDir, "Settings.json");
-				if (Configuration.SettingsFileIsValid(defaultSettingsFile))
+				if (File.Exists(defaultSettingsFile) && Configuration.SettingsFileIsValid(defaultSettingsFile))
 					Configuration.SetLibationFiles(defaultLibationFilesDir);
 
 				if (config.LibationSettingsAreValid)
@@ -103,7 +105,6 @@ public class App : Application
 		{
 			if (setupDialog.IsNewUser)
 			{
-				Configuration.SetLibationFiles(Configuration.DefaultLibationFilesDirectory);
 				setupDialog.Config.Books = Configuration.DefaultBooksDirectory;
 
 				if (setupDialog.Config.LibationSettingsAreValid)
diff --git a/Source/LibationFileManager/Configuration.KnownDirectories.cs b/Source/LibationFileManager/Configuration.KnownDirectories.cs
index e0871f86..9a052d20 100644
--- a/Source/LibationFileManager/Configuration.KnownDirectories.cs
+++ b/Source/LibationFileManager/Configuration.KnownDirectories.cs
@@ -19,9 +19,13 @@ namespace LibationFileManager
         public static string UserProfile => Path.GetFullPath(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), "Libation"));
         public static string LocalAppData => Path.GetFullPath(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "Libation"));
         public static string DefaultLibationFilesDirectory => !IsWindows ? LocalAppData : UserProfile;
-        public static string DefaultBooksDirectory => Path.Combine(!IsWindows ? MyMusic : UserProfile, nameof(Books));
+        public static string DefaultBooksDirectory
+            => !IsWindows ? Path.Combine(MyMusic, nameof(Books))
+            : LibationSettingsDirectory is null ? Path.Combine(UserProfile, nameof(Books))
+            : Path.Combine(LibationSettingsDirectory, nameof(Books));
 
-        public enum KnownDirectories
+
+		public enum KnownDirectories
         {
             None = 0,
 
diff --git a/Source/LibationWinForms/Program.cs b/Source/LibationWinForms/Program.cs
index 61eb28f0..12c49b6f 100644
--- a/Source/LibationWinForms/Program.cs
+++ b/Source/LibationWinForms/Program.cs
@@ -126,8 +126,10 @@ namespace LibationWinForms
 			var defaultLibationFilesDir = Configuration.DefaultLibationFilesDirectory;
 
 			// check for existing settings in default location
+			// First check if file exists so that, if it doesn't, we don't
+			// overwrite user's LibationFiles setting in appsettings.json
 			var defaultSettingsFile = Path.Combine(defaultLibationFilesDir, "Settings.json");
-			if (Configuration.SettingsFileIsValid(defaultSettingsFile))
+			if (File.Exists(defaultSettingsFile) && Configuration.SettingsFileIsValid(defaultSettingsFile))
 				Configuration.SetLibationFiles(defaultLibationFilesDir);
 
 			if (config.LibationSettingsAreValid)
@@ -149,7 +151,6 @@ namespace LibationWinForms
 
 			if (setupDialog.IsNewUser)
 			{
-				Configuration.SetLibationFiles(defaultLibationFilesDir);
 				config.Books = Configuration.DefaultBooksDirectory;
 			}
 			else if (setupDialog.IsReturningUser)

From 59f66ff4807b3c382367aadd1eaa87beef80e1f4 Mon Sep 17 00:00:00 2001
From: Michael Bucari-Tovo <mbucari1@gmail.com>
Date: Fri, 14 Nov 2025 13:43:54 -0700
Subject: [PATCH 13/18] Fix subdirectory create failing on root drive (#1432)

This appears to be a bug in .NET. Someone started to fix it in a PR, but it went stale and was auto-closed.

https://github.com/dotnet/runtime/pull/117519
---
 Source/FileManager/FileUtility.cs            | 22 ++++++++++++++++++++
 Source/LibationFileManager/PictureStorage.cs |  5 +++--
 Source/LibationSearchEngine/SearchEngine.cs  |  3 ++-
 3 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/Source/FileManager/FileUtility.cs b/Source/FileManager/FileUtility.cs
index 137b817f..387178a1 100644
--- a/Source/FileManager/FileUtility.cs
+++ b/Source/FileManager/FileUtility.cs
@@ -263,5 +263,27 @@ namespace FileManager
 
 			return foundFiles;
 		}
+
+		/// <summary>
+		/// Creates a subdirectory or subdirectories on the specified path.
+		/// The specified path can be relative to this instance of the <see cref="DirectoryInfo"/> class.
+		/// <para/>
+		/// Fixes an issue with <see cref="DirectoryInfo.CreateSubdirectory(string)"/> where it fails when the parent <see cref="DirectoryInfo"/> is a drive root.
+		/// </summary>
+		/// <param name="path">The specified path. This cannot be a different disk volume or Universal Naming Convention (UNC) name.</param>
+		/// <returns>The last directory specified in <paramref name="path"/></returns>
+		public static DirectoryInfo CreateSubdirectoryEx(this DirectoryInfo parent, string path)
+		{
+			if (parent.Root.FullName != parent.FullName || Path.IsPathRooted(path))
+				return parent.CreateSubdirectory(path);
+
+			// parent is a drive root and subDirectory is relative
+			//Solves a problem with DirectoryInfo.CreateSubdirectory where it fails
+			//If the parent DirectoryInfo is a drive root.
+			var fullPath = Path.GetFullPath(Path.Combine(parent.FullName, path));
+			var directoryInfo = new DirectoryInfo(fullPath);
+			directoryInfo.Create();
+			return directoryInfo;
+		}
 	}
 }
diff --git a/Source/LibationFileManager/PictureStorage.cs b/Source/LibationFileManager/PictureStorage.cs
index 582d55d8..dccd4d42 100644
--- a/Source/LibationFileManager/PictureStorage.cs
+++ b/Source/LibationFileManager/PictureStorage.cs
@@ -1,4 +1,5 @@
-using System;
+using FileManager;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.IO;
@@ -42,7 +43,7 @@ namespace LibationFileManager
     {
         // not customizable. don't move to config
         private static string ImagesDirectory { get; }
-            = new DirectoryInfo(Configuration.Instance.LibationFiles).CreateSubdirectory("Images").FullName;
+            = new DirectoryInfo(Configuration.Instance.LibationFiles).CreateSubdirectoryEx("Images").FullName;
 
 		private static string getPath(PictureDefinition def)
 			=> Path.Combine(ImagesDirectory, $"{def.PictureId}{def.Size}.jpg");
diff --git a/Source/LibationSearchEngine/SearchEngine.cs b/Source/LibationSearchEngine/SearchEngine.cs
index b922175b..f1bd1075 100644
--- a/Source/LibationSearchEngine/SearchEngine.cs
+++ b/Source/LibationSearchEngine/SearchEngine.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Linq;
 using DataLayer;
 using Dinah.Core;
+using FileManager;
 using LibationFileManager;
 using Lucene.Net.Analysis.Standard;
 using Lucene.Net.Documents;
@@ -279,6 +280,6 @@ namespace LibationSearchEngine
 
         // not customizable. don't move to config
         private static string SearchEngineDirectory { get; }
-            = new System.IO.DirectoryInfo(Configuration.Instance.LibationFiles).CreateSubdirectory("SearchEngine").FullName;
+            = new System.IO.DirectoryInfo(Configuration.Instance.LibationFiles).CreateSubdirectoryEx("SearchEngine").FullName;
     }
 }

From e8c911e60304e2901f20a74a165b72776950e76c Mon Sep 17 00:00:00 2001
From: MBucari <mbucari1@gmail.com>
Date: Sun, 16 Nov 2025 21:08:26 -0700
Subject: [PATCH 14/18] Improve management and validation of Libation settings

- Move all settings file logic into new LibationFiles class
  - Configuration.LibationFiles is a singleton instance of the LibationFiles class.
  - A LibationFiles instance is bound to a single appsettings.json path. All updates to LibationFiles location are updated in that appsettings.json file
- Unify initial setup and settings validation process
  - Add LibationSetup which handles all startup validation of settings files and prompts users for setup if needed
  - Added a new LibationUiBase.Tests test project with tests for various
---
 Source/AppScaffolding/LibationScaffolding.cs  |   7 +-
 .../AppScaffolding/UNSAFE_MigrationHelper.cs  |  10 +-
 Source/ApplicationServices/LibraryCommands.cs |   6 +-
 Source/AudibleUtilities/AudibleApiStorage.cs  |   2 +-
 Source/Libation.sln                           |   7 +
 Source/LibationAvalonia/App.axaml.cs          | 216 ++++----------
 .../Dialogs/EditTemplateDialog.axaml.cs       |   2 +-
 .../Dialogs/LibationFilesDialog.axaml.cs      |  27 +-
 .../MessageBoxAlertAdminDialog.axaml.cs       |   2 +-
 .../Dialogs/SetupDialog.axaml.cs              |   4 +-
 Source/LibationAvalonia/MessageBox.cs         |  13 +-
 Source/LibationAvalonia/Program.cs            |  10 +-
 .../Themes/ChardonnayThemePersister.cs        |   2 +-
 .../ViewModels/MainVM.Export.cs               |   3 +-
 .../Settings/ImportantSettingsVM.cs           |   4 +-
 .../Configuration.KnownDirectories.cs         |  14 +-
 .../Configuration.LibationFiles.cs            | 216 --------------
 .../Configuration.Logging.cs                  |   2 +-
 .../Configuration.PersistentSettings.cs       |  21 +-
 Source/LibationFileManager/Configuration.cs   |  60 +---
 Source/LibationFileManager/FilePathCache.cs   |   2 +-
 Source/LibationFileManager/LibationFiles.cs   | 263 ++++++++++++++++++
 Source/LibationFileManager/PictureStorage.cs  |   2 +-
 Source/LibationFileManager/QuickFilters.cs    |   2 +-
 Source/LibationFileManager/SqliteStorage.cs   |   2 +-
 Source/LibationSearchEngine/SearchEngine.cs   |   2 +-
 Source/LibationUiBase/LibationSetup.cs        | 242 ++++++++++++++++
 .../Dialogs/LibationFilesDialog.cs            |  14 +-
 .../Dialogs/MessageBoxAlertAdminDialog.cs     |   2 +-
 .../Dialogs/SettingsDialog.Important.cs       |   2 +-
 .../LibationWinForms/Dialogs/SetupDialog.cs   |   5 +-
 Source/LibationWinForms/Program.cs            | 132 ++++-----
 .../TemplatesTests.cs                         |   8 +-
 .../LibationUiBase.Tests/LibationFilesTest.cs | 255 +++++++++++++++++
 .../LibationUiBase.Tests.csproj               |  23 ++
 35 files changed, 993 insertions(+), 591 deletions(-)
 delete mode 100644 Source/LibationFileManager/Configuration.LibationFiles.cs
 create mode 100644 Source/LibationFileManager/LibationFiles.cs
 create mode 100644 Source/LibationUiBase/LibationSetup.cs
 create mode 100644 Source/_Tests/LibationUiBase.Tests/LibationFilesTest.cs
 create mode 100644 Source/_Tests/LibationUiBase.Tests/LibationUiBase.Tests.csproj

diff --git a/Source/AppScaffolding/LibationScaffolding.cs b/Source/AppScaffolding/LibationScaffolding.cs
index 2b512e81..4514869c 100644
--- a/Source/AppScaffolding/LibationScaffolding.cs
+++ b/Source/AppScaffolding/LibationScaffolding.cs
@@ -81,6 +81,7 @@ namespace AppScaffolding
 		/// <summary>most migrations go in here</summary>
 		public static void RunPostConfigMigrations(Configuration config)
 		{
+			config.LoadPersistentSettings(config.LibationFiles.SettingsFilePath);
 			AudibleApiStorage.EnsureAccountsSettingsFileExists();
 
 			//
@@ -150,7 +151,7 @@ namespace AppScaffolding
 								new JObject
 								{
 									// for this sink to work, a path must be provided. we override this below
-									{ "path", Path.Combine(config.LibationFiles, "Log.log") },
+									{ "path", Path.Combine(config.LibationFiles.Location, "Log.log") },
 									{ "rollingInterval", "Month" },
 									// Serilog template formatting examples
 									// - default:                    "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}"
@@ -433,8 +434,8 @@ namespace AppScaffolding
 			const string FILENAME_V1 = "FileLocations.json";
 			const string FILENAME_V2 = "FileLocationsV2.json";
 
-			var jsonFileV1 = Path.Combine(Configuration.Instance.LibationFiles, FILENAME_V1);
-			var jsonFileV2 = Path.Combine(Configuration.Instance.LibationFiles, FILENAME_V2);
+			var jsonFileV1 = Path.Combine(Configuration.Instance.LibationFiles.Location, FILENAME_V1);
+			var jsonFileV2 = Path.Combine(Configuration.Instance.LibationFiles.Location, FILENAME_V2);
 
 			if (!File.Exists(jsonFileV2) && File.Exists(jsonFileV1))
 			{
diff --git a/Source/AppScaffolding/UNSAFE_MigrationHelper.cs b/Source/AppScaffolding/UNSAFE_MigrationHelper.cs
index 63327778..89597ab5 100644
--- a/Source/AppScaffolding/UNSAFE_MigrationHelper.cs
+++ b/Source/AppScaffolding/UNSAFE_MigrationHelper.cs
@@ -21,7 +21,7 @@ namespace AppScaffolding
 	public static class UNSAFE_MigrationHelper
 	{
 		public static string SettingsDirectory
-			=> !APPSETTINGS_TryGet(LIBATION_FILES_KEY, out var value) || value is null
+			=> !APPSETTINGS_TryGet(LibationFiles.LIBATION_FILES_KEY, out var value) || value is null
 			? null
 			: value;
 
@@ -59,7 +59,7 @@ namespace AppScaffolding
 		/// <param name="save">True: save if contents changed. False: no not attempt save</param>
 		private static void process_APPSETTINGS_Json(Action<JObject> action, bool save = true)
 		{
-			var startingContents = File.ReadAllText(Configuration.AppsettingsJsonFile);
+			var startingContents = File.ReadAllText(Configuration.Instance.LibationFiles.AppsettingsJsonFile);
 
 			JObject jObj;
 			try
@@ -82,15 +82,13 @@ namespace AppScaffolding
 			if (startingContents.EqualsInsensitive(endingContents_indented) || startingContents.EqualsInsensitive(endingContents_compact))
 				return;
 
-			File.WriteAllText(Configuration.AppsettingsJsonFile, endingContents_indented);
+			File.WriteAllText(Configuration.Instance.LibationFiles.AppsettingsJsonFile, endingContents_indented);
 			System.Threading.Thread.Sleep(100);
 		}
 		#endregion
 		#region Settings.json
-		public const string LIBATION_FILES_KEY = "LibationFiles";
-		private const string SETTINGS_JSON = "Settings.json";
 
-		public static string SettingsJsonPath => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, SETTINGS_JSON);
+		public static string SettingsJsonPath => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LibationFiles.SETTINGS_JSON);
 		public static bool SettingsJson_Exists => SettingsJsonPath is not null && File.Exists(SettingsJsonPath);
 
 		public static bool Settings_TryGet(string key, out string value)
diff --git a/Source/ApplicationServices/LibraryCommands.cs b/Source/ApplicationServices/LibraryCommands.cs
index f2e2a7cc..f750eaff 100644
--- a/Source/ApplicationServices/LibraryCommands.cs
+++ b/Source/ApplicationServices/LibraryCommands.cs
@@ -70,7 +70,7 @@ namespace ApplicationServices
             }
             catch (AudibleApi.Authentication.LoginFailedException lfEx)
             {
-                lfEx.SaveFiles(Configuration.Instance.LibationFiles);
+                lfEx.SaveFiles(Configuration.Instance.LibationFiles.Location);
 
                 // nuget Serilog.Exceptions would automatically log custom properties
                 //   However, it comes with a scary warning when used with EntityFrameworkCore which I'm not yet ready to implement:
@@ -150,7 +150,7 @@ namespace ApplicationServices
             }
             catch (AudibleApi.Authentication.LoginFailedException lfEx)
             {
-                lfEx.SaveFiles(Configuration.Instance.LibationFiles);
+                lfEx.SaveFiles(Configuration.Instance.LibationFiles.Location);
 
                 // nuget Serilog.Exceptions would automatically log custom properties
                 //   However, it comes with a scary warning when used with EntityFrameworkCore which I'm not yet ready to implement:
@@ -268,7 +268,7 @@ namespace ApplicationServices
 
            await using LogArchiver? archiver
                 = Log.Logger.IsDebugEnabled()
-                ? openLogArchive(System.IO.Path.Combine(Configuration.Instance.LibationFiles, "LibraryScans.zip"))
+                ? openLogArchive(System.IO.Path.Combine(Configuration.Instance.LibationFiles.Location, "LibraryScans.zip"))
                 : default;
 
 			archiver?.DeleteAllButNewestN(20);
diff --git a/Source/AudibleUtilities/AudibleApiStorage.cs b/Source/AudibleUtilities/AudibleApiStorage.cs
index 2fb43e8b..f0d07005 100644
--- a/Source/AudibleUtilities/AudibleApiStorage.cs
+++ b/Source/AudibleUtilities/AudibleApiStorage.cs
@@ -25,7 +25,7 @@ namespace AudibleUtilities
 
 	public static class AudibleApiStorage
 	{
-		public static string AccountsSettingsFile => Path.Combine(Configuration.Instance.LibationFiles, "AccountsSettings.json");
+		public static string AccountsSettingsFile => Path.Combine(Configuration.Instance.LibationFiles.Location, "AccountsSettings.json");
 
 		public static event EventHandler<AccountSettingsLoadErrorEventArgs> LoadError;
 
diff --git a/Source/Libation.sln b/Source/Libation.sln
index a542ff36..95a4f7af 100644
--- a/Source/Libation.sln
+++ b/Source/Libation.sln
@@ -109,6 +109,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DataLayer.Postgres", "DataL
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DataLayer.Sqlite", "DataLayer.Sqlite\DataLayer.Sqlite.csproj", "{1E689E85-279E-39D4-7D97-3E993FB6D95B}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LibationUiBase.Tests", "_Tests\LibationUiBase.Tests\LibationUiBase.Tests.csproj", "{6F9DB713-2879-4B14-9F9E-3B13C9B7F35C}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -239,6 +241,10 @@ Global
 		{1E689E85-279E-39D4-7D97-3E993FB6D95B}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{1E689E85-279E-39D4-7D97-3E993FB6D95B}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{1E689E85-279E-39D4-7D97-3E993FB6D95B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6F9DB713-2879-4B14-9F9E-3B13C9B7F35C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6F9DB713-2879-4B14-9F9E-3B13C9B7F35C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6F9DB713-2879-4B14-9F9E-3B13C9B7F35C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6F9DB713-2879-4B14-9F9E-3B13C9B7F35C}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -280,6 +286,7 @@ Global
 		{CFE7A0E5-37FE-40BE-A70B-41B5104181C4} = {67E66E82-5532-4440-AFB3-9FB1DF9DEF53}
 		{0E480D2D-C7C1-A6FE-8C90-8A6F0DBCEAC2} = {751093DD-5DBA-463E-ADBE-E05FAFB6983E}
 		{1E689E85-279E-39D4-7D97-3E993FB6D95B} = {751093DD-5DBA-463E-ADBE-E05FAFB6983E}
+		{6F9DB713-2879-4B14-9F9E-3B13C9B7F35C} = {67E66E82-5532-4440-AFB3-9FB1DF9DEF53}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {615E00ED-BAEF-4E8E-A92A-9B82D87942A9}
diff --git a/Source/LibationAvalonia/App.axaml.cs b/Source/LibationAvalonia/App.axaml.cs
index 8eedfbb4..9bf752c7 100644
--- a/Source/LibationAvalonia/App.axaml.cs
+++ b/Source/LibationAvalonia/App.axaml.cs
@@ -1,4 +1,5 @@
 using ApplicationServices;
+using AppScaffolding;
 using Avalonia;
 using Avalonia.Controls;
 using Avalonia.Controls.ApplicationLifetimes;
@@ -12,6 +13,7 @@ using LibationAvalonia.Dialogs;
 using LibationAvalonia.Themes;
 using LibationAvalonia.Views;
 using LibationFileManager;
+using LibationUiBase;
 using LibationUiBase.Forms;
 using System;
 using System.Collections.Generic;
@@ -41,51 +43,70 @@ public class App : Application
 
 		if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
 		{
-			// Chardonnay uses the OnLastWindowClose shutdown mode. As long as the application lifetime
-			// has one active window, the application will stay alive. Setup windows must be daisy chained,
-			// each closing windows opens the next window before closing itself to prevent the app from exiting.
-
+			// Chardonnay uses the OnExplicitShutdown shutdown mode. The application will stay alive until
+			// Shutdown() is called on App.Current.ApplicationLifetime.
 			MessageBoxBase.ShowAsyncImpl = (owner, message, caption, buttons, icon, defaultButton, saveAndRestorePosition) =>
 				MessageBox.Show(owner as Window, message, caption, buttons, icon, defaultButton, saveAndRestorePosition);
 
 			// Avoid duplicate validations from both Avalonia and the CommunityToolkit. 
 			// More info: https://docs.avaloniaui.net/docs/guides/development-guides/data-validation#manage-validationplugins
 			DisableAvaloniaDataAnnotationValidation();
-
-			Configuration config = Configuration.Instance;
-
-			if (!config.LibationSettingsAreValid)
-			{
-				string defaultLibationFilesDir = Configuration.DefaultLibationFilesDirectory;
-
-				// check for existing settings in default location.
-				// First check if file exists so that, if it doesn't, we don't
-				// overwrite user's LibationFiles setting in appsettings.json
-				string defaultSettingsFile = Path.Combine(defaultLibationFilesDir, "Settings.json");
-				if (File.Exists(defaultSettingsFile) && Configuration.SettingsFileIsValid(defaultSettingsFile))
-					Configuration.SetLibationFiles(defaultLibationFilesDir);
-
-				if (config.LibationSettingsAreValid)
-				{
-					LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
-					ShowMainWindow(desktop);
-				}
-				else
-				{
-					SetupDialog setupDialog = new() { Config = config };
-					setupDialog.Closing += (_, e) => SetupClosing(setupDialog, desktop, e);
-					desktop.MainWindow = setupDialog;
-				}
-			}
-			else
-			{
-				ShowMainWindow(desktop);
-			}
+			RunSetupIfNeededAsync(desktop, Configuration.Instance);
 		}
 
 		base.OnFrameworkInitializationCompleted();
 	}
 
+	private static async void RunSetupIfNeededAsync(IClassicDesktopStyleApplicationLifetime desktop, Configuration config)
+	{
+		var setup = new LibationSetup(config.LibationFiles)
+		{
+			SetupPromptAsync =() => ShowSetupAsync(desktop),
+			SelectFolderPromptAsync = () => SelectInstallLocation(desktop, config.LibationFiles)
+		};
+		if (await setup.RunSetupIfNeededAsync())
+		{
+			// setup succeeded or wasn't needed and LibationFiles are valid
+			await RunMigrationsAsync(config);
+			LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
+			ShowMainWindow(desktop);
+		}
+		else
+		{
+			await MessageBox.Show("Initial set up cancelled.", "Cancelled", MessageBoxButtons.OK, MessageBoxIcon.Warning);
+			desktop.Shutdown(-1);
+		}
+	}
+
+	static async Task<ILibationSetup> ShowSetupAsync(IClassicDesktopStyleApplicationLifetime desktop)
+	{
+		var tcs = new TaskCompletionSource<ILibationSetup>();
+		var setupDialog = new SetupDialog();
+		desktop.MainWindow = setupDialog;
+		setupDialog.Closed += (_, _) => tcs.SetResult(setupDialog);
+		setupDialog.Show();
+		return await tcs.Task;
+	}
+
+	static async Task<ILibationInstallLocation?> SelectInstallLocation(IClassicDesktopStyleApplicationLifetime desktop, LibationFiles libationFiles)
+	{
+		var tcs = new TaskCompletionSource<ILibationInstallLocation>();
+		var libationFilesDialog = new LibationFilesDialog(libationFiles.Location.PathWithoutPrefix);
+		desktop.MainWindow = libationFilesDialog;
+		libationFilesDialog.Closed += (_, _) => tcs.SetResult(libationFilesDialog);
+		libationFilesDialog.Show();
+		return await tcs.Task;
+	}
+
+	private static async Task RunMigrationsAsync(Configuration config)
+	{
+		// most migrations go in here
+		LibationScaffolding.RunPostConfigMigrations(config);
+		await MessageBox.VerboseLoggingWarning_ShowIfTrue();
+		// logging is init'd here
+		LibationScaffolding.RunPostMigrationScaffolding(Variety.Chardonnay, config);
+	}
+
 	private void DisableAvaloniaDataAnnotationValidation()
 	{
 		// Get an array of plugins to remove
@@ -99,132 +120,6 @@ public class App : Application
 		}
 	}
 
-	private async void SetupClosing(SetupDialog setupDialog, IClassicDesktopStyleApplicationLifetime desktop, System.ComponentModel.CancelEventArgs e)
-	{
-		try
-		{
-			if (setupDialog.IsNewUser)
-			{
-				setupDialog.Config.Books = Configuration.DefaultBooksDirectory;
-
-				if (setupDialog.Config.LibationSettingsAreValid)
-				{
-					string? theme = setupDialog.SelectedTheme.Content as string;
-					setupDialog.Config.SetString(theme, nameof(ThemeVariant));
-
-					await RunMigrationsAsync(setupDialog.Config);
-					LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
-					AudibleUtilities.AudibleApiStorage.EnsureAccountsSettingsFileExists();
-					ShowMainWindow(desktop);
-				}
-				else
-				{
-					e.Cancel = true;
-					await CancelInstallation(setupDialog);
-				}
-			}
-			else if (setupDialog.IsReturningUser)
-			{
-				ShowLibationFilesDialog(desktop, setupDialog.Config);
-			}
-			else
-			{
-				e.Cancel = true;
-				await CancelInstallation(setupDialog);
-			}
-		}
-		catch (Exception ex)
-		{
-			string title = "Fatal error, pre-logging";
-			string body = "An unrecoverable error occurred. Since this error happened before logging could be initialized, this error can not be written to the log file.";
-
-			MessageBoxAlertAdminDialog alert = new(body, title, ex);
-			desktop.MainWindow = alert;
-			alert.Show();
-		}
-	}
-
-	private void ShowLibationFilesDialog(IClassicDesktopStyleApplicationLifetime desktop, Configuration config)
-	{
-		LibationFilesDialog libationFilesDialog = new();
-		desktop.MainWindow = libationFilesDialog;
-		libationFilesDialog.Show();
-
-		async void WindowClosing(object? sender, System.ComponentModel.CancelEventArgs e)
-		{
-			libationFilesDialog.Closing -= WindowClosing;
-			e.Cancel = true;
-			if (libationFilesDialog.DialogResult == DialogResult.OK)
-				OnLibationFilesCompleted(desktop, libationFilesDialog, config);
-			else
-				await CancelInstallation(libationFilesDialog);
-		}
-		libationFilesDialog.Closing += WindowClosing;
-	}
-
-	private async void OnLibationFilesCompleted(IClassicDesktopStyleApplicationLifetime desktop, LibationFilesDialog libationFilesDialog, Configuration config)
-	{
-		Configuration.SetLibationFiles(libationFilesDialog.SelectedDirectory);
-		if (config.LibationSettingsAreValid)
-		{
-			await RunMigrationsAsync(config);
-
-			LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
-			AudibleUtilities.AudibleApiStorage.EnsureAccountsSettingsFileExists();
-			ShowMainWindow(desktop);
-		}
-		else
-		{
-			// path did not result in valid settings
-			DialogResult continueResult = await MessageBox.Show(
-				libationFilesDialog,
-				$"No valid settings were found at this location.\r\nWould you like to create a new install settings in this folder?\r\n\r\n{libationFilesDialog.SelectedDirectory}",
-				"New install?",
-				MessageBoxButtons.YesNo,
-				MessageBoxIcon.Question);
-
-			if (continueResult == DialogResult.Yes)
-			{
-				config.Books = Path.Combine(libationFilesDialog.SelectedDirectory, nameof(Configuration.Books));
-
-				if (config.LibationSettingsAreValid)
-				{
-					await RunMigrationsAsync(config);
-					LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
-					AudibleUtilities.AudibleApiStorage.EnsureAccountsSettingsFileExists();
-					ShowMainWindow(desktop);
-				}
-				else
-				{
-					await CancelInstallation(libationFilesDialog);
-				}
-			}
-			else
-			{
-				await CancelInstallation(libationFilesDialog);
-			}
-		}
-
-		libationFilesDialog.Close();
-	}
-
-	private static async Task CancelInstallation(Window window)
-	{
-		await MessageBox.Show(window, "Initial set up cancelled.", "Cancelled", MessageBoxButtons.OK, MessageBoxIcon.Warning);
-		Environment.Exit(-1);
-	}
-
-	private async Task RunMigrationsAsync(Configuration config)
-	{
-		// most migrations go in here
-		AppScaffolding.LibationScaffolding.RunPostConfigMigrations(config);
-
-		await MessageBox.VerboseLoggingWarning_ShowIfTrue();
-
-		// logging is init'd here
-		AppScaffolding.LibationScaffolding.RunPostMigrationScaffolding(AppScaffolding.Variety.Chardonnay, config);
-	}
-
 	private static void ShowMainWindow(IClassicDesktopStyleApplicationLifetime desktop)
 	{
 		Configuration.Instance.PropertyChanged += ThemeVariant_PropertyChanged;
@@ -234,6 +129,7 @@ public class App : Application
 		MainWindow mainWindow = new();
 		desktop.MainWindow = MainWindow = mainWindow;
 		mainWindow.Loaded += MainWindow_Loaded;
+		mainWindow.Closed += (_, _) => desktop.Shutdown();
 		mainWindow.RestoreSizeAndLocation(Configuration.Instance);
 		mainWindow.Show();
 	}
diff --git a/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml.cs
index fe82746a..e596a6bb 100644
--- a/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/EditTemplateDialog.axaml.cs
@@ -26,7 +26,7 @@ public partial class EditTemplateDialog : DialogWindow
 		if (Design.IsDesignMode)
 		{
 			var mockInstance = Configuration.CreateMockInstance();
-			mockInstance.Books = Configuration.DefaultBooksDirectory;
+			mockInstance.Books = "/Path/To/Books";
 			RequestedThemeVariant  = ThemeVariant.Dark;
 			var editor = TemplateEditor<Templates.FileTemplate>.CreateFilenameEditor(mockInstance.Books, mockInstance.FileTemplate);
 			_viewModel = new(mockInstance, editor);
diff --git a/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml.cs
index 73c8011a..0105c0cb 100644
--- a/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/LibationFilesDialog.axaml.cs
@@ -1,10 +1,12 @@
 using LibationFileManager;
+using LibationUiBase;
 using LibationUiBase.Forms;
 using System.Collections.Generic;
+using System.IO;
 
 namespace LibationAvalonia.Dialogs
 {
-	public partial class LibationFilesDialog : DialogWindow
+	public partial class LibationFilesDialog : DialogWindow, ILibationInstallLocation
 	{
 		private class DirSelectOptions
 		{
@@ -15,7 +17,7 @@ namespace LibationAvalonia.Dialogs
 				Configuration.KnownDirectories.MyDocs
 			};
 
-			public string Directory { get; set; } = Configuration.GetKnownDirectoryPath(Configuration.KnownDirectories.UserProfile);
+			public string Directory { get; set; }
 		}
 
 		private readonly DirSelectOptions dirSelectOptions;
@@ -28,12 +30,29 @@ namespace LibationAvalonia.Dialogs
 			DataContext = dirSelectOptions = new();
 		}
 
+		public LibationFilesDialog(string initialDir)
+		{
+			dirSelectOptions = new();
+			dirSelectOptions.Directory = Directory.Exists(initialDir) ? initialDir : Configuration.GetKnownDirectoryPath(Configuration.KnownDirectories.UserProfile);
+			InitializeComponent();
+
+			DataContext = dirSelectOptions;
+		}
+
 		public async void Save_Click(object sender, Avalonia.Interactivity.RoutedEventArgs e)
 		{
+
 			if (!System.IO.Directory.Exists(SelectedDirectory))
 			{
-				await MessageBox.Show("Not saving change to Libation Files location. This folder does not exist:\r\n" + SelectedDirectory, "Folder does not exist", MessageBoxButtons.OK, MessageBoxIcon.Error, saveAndRestorePosition: false);
-				return;
+				try
+				{
+					Directory.CreateDirectory(SelectedDirectory);
+				}
+				catch
+				{
+					await MessageBox.Show("Not saving change to Libation Files location. This folder does not exist:\r\n" + SelectedDirectory, "Folder does not exist", MessageBoxButtons.OK, MessageBoxIcon.Error, saveAndRestorePosition: false);
+					return;
+				}
 			}
 
 			await SaveAndCloseAsync();
diff --git a/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml.cs
index 7307263b..b83422f2 100644
--- a/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/MessageBoxAlertAdminDialog.axaml.cs
@@ -52,7 +52,7 @@ namespace LibationAvalonia.Dialogs
 				LongPath dir = "";
 				try
 				{
-					dir = LibationFileManager.Configuration.Instance.LibationFiles;
+					dir = LibationFileManager.Configuration.Instance.LibationFiles.Location;
 					Go.To.Folder(dir.ShortPathName);
 				}
 				catch
diff --git a/Source/LibationAvalonia/Dialogs/SetupDialog.axaml.cs b/Source/LibationAvalonia/Dialogs/SetupDialog.axaml.cs
index 9745b9b0..88383ca2 100644
--- a/Source/LibationAvalonia/Dialogs/SetupDialog.axaml.cs
+++ b/Source/LibationAvalonia/Dialogs/SetupDialog.axaml.cs
@@ -1,15 +1,15 @@
 using Avalonia.Controls;
 using LibationFileManager;
+using LibationUiBase;
 using LibationUiBase.Forms;
 
 namespace LibationAvalonia.Dialogs
 {
-	public partial class SetupDialog : Window
+	public partial class SetupDialog : Window, ILibationSetup
 	{
 		public bool IsNewUser { get; private set; }
 		public bool IsReturningUser { get; private set; }
 		public ComboBoxItem SelectedTheme { get; set; }
-		public Configuration Config { get; init; }
 		public SetupDialog()
 		{
 			InitializeComponent();
diff --git a/Source/LibationAvalonia/MessageBox.cs b/Source/LibationAvalonia/MessageBox.cs
index 290b254f..e94c7f0f 100644
--- a/Source/LibationAvalonia/MessageBox.cs
+++ b/Source/LibationAvalonia/MessageBox.cs
@@ -152,13 +152,22 @@ namespace LibationAvalonia
 			dialog.Width = dialog.MinWidth;
 			return dialog;
 		}
-		private static async Task<DialogResult> DisplayWindow(Window toDisplay, Window owner)
+		private static async Task<DialogResult> DisplayWindow(DialogWindow toDisplay, Window owner)
 		{
 			if (owner is null)
 			{
 				if (Application.Current.ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
 				{
-					return await toDisplay.ShowDialog<DialogResult>(desktop.MainWindow);
+					if (desktop.MainWindow.IsLoaded)
+						return await toDisplay.ShowDialog<DialogResult>(desktop.MainWindow);
+					else
+					{
+						var tcs = new TaskCompletionSource<DialogResult>();
+						desktop.MainWindow = toDisplay;
+						toDisplay.Closed += (_, _) => tcs.SetResult(toDisplay.DialogResult);
+						toDisplay.Show();
+						return await tcs.Task;
+					}
 				}
 				else
 				{
diff --git a/Source/LibationAvalonia/Program.cs b/Source/LibationAvalonia/Program.cs
index f9b84f6d..d0c7a3ec 100644
--- a/Source/LibationAvalonia/Program.cs
+++ b/Source/LibationAvalonia/Program.cs
@@ -51,7 +51,7 @@ namespace LibationAvalonia
 			try
 			{
 				var config = LibationScaffolding.RunPreConfigMigrations();
-				if (config.LibationSettingsAreValid)
+				if (config.LibationFiles.SettingsAreValid)
 				{
 					// most migrations go in here
 					LibationScaffolding.RunPostConfigMigrations(config);
@@ -60,7 +60,7 @@ namespace LibationAvalonia
 					//Start loading the library before loading the main form
 					App.LibraryTask = Task.Run(() => DbContexts.GetLibrary_Flat_NoTracking(includeParents: true));
 				}
-				BuildAvaloniaApp()?.StartWithClassicDesktopLifetime([]);
+				BuildAvaloniaApp()?.StartWithClassicDesktopLifetime([], ShutdownMode.OnExplicitShutdown);
 			}
 			catch (Exception ex)
 			{
@@ -149,7 +149,7 @@ namespace LibationAvalonia
 			 Version               {LibationScaffolding.BuildVersion}
 			 ReleaseIdentifier     {LibationScaffolding.ReleaseIdentifier}
 			 InteropFunctionsType  {InteropFactory.InteropFunctionsType}
-			 LibationFiles         {getConfigValue(c => c.LibationFiles)}
+			 LibationFiles         {getConfigValue(c => c.LibationFiles.Location)}
 			 Books Folder          {getConfigValue(c => c.Books)}
 			 === EXCEPTION ===
 			 {exceptionObject}
@@ -161,7 +161,7 @@ namespace LibationAvalonia
 				//Try to add crash message to the newest existing Libation log file
 				//then to LibationFiles/LibationCrash.log
 				//then to %UserProfile%/LibationCrash.log
-				string logDir = Configuration.Instance.LibationFiles;
+				string logDir = Configuration.Instance.LibationFiles.Location;
 				var existingLogFiles = Directory.GetFiles(logDir, "Log*.log");
 
 				logFile = existingLogFiles.Length == 0 ? getFallbackLogFile()
@@ -193,7 +193,7 @@ namespace LibationAvalonia
 				try
 				{
 
-					string logDir = Configuration.Instance.LibationFiles;
+					string logDir = Configuration.Instance.LibationFiles.Location;
 					if (!Directory.Exists(logDir))
 						logDir = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
 
diff --git a/Source/LibationAvalonia/Themes/ChardonnayThemePersister.cs b/Source/LibationAvalonia/Themes/ChardonnayThemePersister.cs
index 977efca7..94ecb243 100644
--- a/Source/LibationAvalonia/Themes/ChardonnayThemePersister.cs
+++ b/Source/LibationAvalonia/Themes/ChardonnayThemePersister.cs
@@ -10,7 +10,7 @@ namespace LibationAvalonia.Themes;
 
 public class ChardonnayThemePersister : JsonFilePersister<ChardonnayTheme>
 {
-	public static string jsonPath = System.IO.Path.Combine(Configuration.Instance.LibationFiles, "ChardonnayTheme.json");
+	public static string jsonPath = System.IO.Path.Combine(Configuration.Instance.LibationFiles.Location, "ChardonnayTheme.json");
 
 	public ChardonnayThemePersister(string path)
 		: base(path, null) { }
diff --git a/Source/LibationAvalonia/ViewModels/MainVM.Export.cs b/Source/LibationAvalonia/ViewModels/MainVM.Export.cs
index e7ec6830..6f551fd3 100644
--- a/Source/LibationAvalonia/ViewModels/MainVM.Export.cs
+++ b/Source/LibationAvalonia/ViewModels/MainVM.Export.cs
@@ -16,10 +16,11 @@ namespace LibationAvalonia.ViewModels
 		{
 			try
 			{
+				var startFolder = Configuration.Instance.Books?.PathWithoutPrefix;
 				var options = new FilePickerSaveOptions
 				{
 					Title = "Where to export Library",
-					SuggestedStartLocation = await MainWindow.StorageProvider.TryGetFolderFromPathAsync(Configuration.Instance.Books?.PathWithoutPrefix ?? Configuration.DefaultBooksDirectory),
+					SuggestedStartLocation = startFolder is null ? null : await MainWindow.StorageProvider.TryGetFolderFromPathAsync(startFolder),
 					SuggestedFileName = $"Libation Library Export {DateTime.Now:yyyy-MM-dd}",
 					DefaultExtension = "xlsx",
 					ShowOverwritePrompt = true,
diff --git a/Source/LibationAvalonia/ViewModels/Settings/ImportantSettingsVM.cs b/Source/LibationAvalonia/ViewModels/Settings/ImportantSettingsVM.cs
index f651640b..eaf5e5fc 100644
--- a/Source/LibationAvalonia/ViewModels/Settings/ImportantSettingsVM.cs
+++ b/Source/LibationAvalonia/ViewModels/Settings/ImportantSettingsVM.cs
@@ -20,7 +20,7 @@ namespace LibationAvalonia.ViewModels.Settings
 		{
 			this.config = config;
 
-			BooksDirectory = config.Books?.PathWithoutPrefix ?? Configuration.DefaultBooksDirectory;
+			BooksDirectory = config.Books?.PathWithoutPrefix ?? "";
 			SavePodcastsToParentFolder = config.SavePodcastsToParentFolder;
 			OverwriteExisting = config.OverwriteExisting;
 			CreationTime = DateTimeSources.SingleOrDefault(v => v.Value == config.CreationTime) ?? DateTimeSources[0];
@@ -64,7 +64,7 @@ namespace LibationAvalonia.ViewModels.Settings
 			if (System.IO.File.Exists(LogFileFilter.LogFilePath))
 				Go.To.File(LogFileFilter.LogFilePath);
 			else
-				Go.To.Folder(((LongPath)Configuration.Instance.LibationFiles).ShortPathName);
+				Go.To.Folder(Configuration.Instance.LibationFiles.Location.ShortPathName);
 		}
 
 		public List<Configuration.KnownDirectories> KnownDirectories { get; } = new()
diff --git a/Source/LibationFileManager/Configuration.KnownDirectories.cs b/Source/LibationFileManager/Configuration.KnownDirectories.cs
index 9a052d20..176a80c2 100644
--- a/Source/LibationFileManager/Configuration.KnownDirectories.cs
+++ b/Source/LibationFileManager/Configuration.KnownDirectories.cs
@@ -8,22 +8,16 @@ using Dinah.Core;
 #nullable enable
 namespace LibationFileManager
 {
-    public partial class Configuration
+    public partial class Configuration 
     {
         public static string ProcessDirectory { get; } = Path.GetDirectoryName(Environment.ProcessPath)!;
-		public static string AppDir_Relative => $@".{Path.DirectorySeparatorChar}{LIBATION_FILES_KEY}";
-        public static string AppDir_Absolute => Path.GetFullPath(Path.Combine(ProcessDirectory, LIBATION_FILES_KEY));
+		public static string AppDir_Relative => $@".{Path.DirectorySeparatorChar}{LibationFiles.LIBATION_FILES_KEY}";
+        public static string AppDir_Absolute => Path.GetFullPath(Path.Combine(ProcessDirectory, LibationFiles.LIBATION_FILES_KEY));
         public static string MyDocs => Path.GetFullPath(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "Libation"));
         public static string MyMusic => Path.GetFullPath(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyMusic), "Libation"));
         public static string WinTemp => Path.GetFullPath(Path.Combine(Path.GetTempPath(), "Libation"));
         public static string UserProfile => Path.GetFullPath(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), "Libation"));
         public static string LocalAppData => Path.GetFullPath(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "Libation"));
-        public static string DefaultLibationFilesDirectory => !IsWindows ? LocalAppData : UserProfile;
-        public static string DefaultBooksDirectory
-            => !IsWindows ? Path.Combine(MyMusic, nameof(Books))
-            : LibationSettingsDirectory is null ? Path.Combine(UserProfile, nameof(Books))
-            : Path.Combine(LibationSettingsDirectory, nameof(Books));
-
 
 		public enum KnownDirectories
         {
@@ -62,7 +56,7 @@ namespace LibationFileManager
             (KnownDirectories.MyDocs, () => MyDocs),
 			// this is important to not let very early calls try to accidentally load LibationFiles too early.
 			// also, keep this at bottom of this list
-			(KnownDirectories.LibationFiles, () => LibationSettingsDirectory)
+			(KnownDirectories.LibationFiles, () => Instance.LibationFiles.Location)
         };
         public static string? GetKnownDirectoryPath(KnownDirectories directory)
         {
diff --git a/Source/LibationFileManager/Configuration.LibationFiles.cs b/Source/LibationFileManager/Configuration.LibationFiles.cs
deleted file mode 100644
index 63a2cb1b..00000000
--- a/Source/LibationFileManager/Configuration.LibationFiles.cs
+++ /dev/null
@@ -1,216 +0,0 @@
-using System;
-using System.ComponentModel;
-using System.IO;
-using FileManager;
-using Newtonsoft.Json.Linq;
-using Newtonsoft.Json;
-using Serilog;
-using Dinah.Core.Logging;
-using System.Diagnostics;
-
-#nullable enable
-namespace LibationFileManager
-{
-    public partial class Configuration
-    {
-        public static string AppsettingsJsonFile { get; } = getOrCreateAppsettingsFile();
-
-		private const string LIBATION_FILES_KEY = "LibationFiles";
-
-        [Description("Location for storage of program-created files")]
-        public string LibationFiles
-        {
-            get
-            {
-				if (LibationSettingsDirectory is not null)
-                    return LibationSettingsDirectory;
-
-                // FIRST: must write here before SettingsFilePath in next step reads cache
-                LibationSettingsDirectory = getLibationFilesSettingFromJson();
-
-                // SECOND. before setting to json file with SetWithJsonPath, PersistentDictionary must exist
-                persistentDictionary = new PersistentDictionary(SettingsFilePath);
-
-                // Config init in ensureSerilogConfig() only happens when serilog setting is first created (prob on 1st run).
-                // This Set() enforces current LibationFiles every time we restart Libation or redirect LibationFiles
-                var logPath = Path.Combine(LibationFiles, "Log.log");
-
-                // BAD: Serilog.WriteTo[1].Args
-                //      "[1]" assumes ordinal position
-                // GOOD: Serilog.WriteTo[?(@.Name=='File')].Args
-                var jsonpath = "Serilog.WriteTo[?(@.Name=='File')].Args";
-
-                SetWithJsonPath(jsonpath, "path", logPath, true);
-
-                return LibationSettingsDirectory;
-            }
-        }
-
-		/// <summary>
-		/// Directory pointed to by appsettings.json
-		/// </summary>
-        private static string? LibationSettingsDirectory { get; set; }
-
-		/// <summary>
-		/// Try to find appsettings.json in the following locations:
-		///  <list type="number">
-		///		<item>
-		///			<description>[App Directory]</description>
-		///		</item>
-		///		<item>
-		///			<description>%LocalAppData%\Libation</description>
-		///		</item>
-		///		<item>
-		///			<description>%AppData%\Libation</description>
-		///		</item>
-		///		<item>
-		///			<description>%Temp%\Libation</description>
-		///		</item>
-		///  </list>   
-		///    
-		/// If not found, try to create it in each of the same locations in-order until successful.
-		///  
-		/// <para>This method must complete successfully for Libation to continue.</para>
-		/// </summary>
-		/// <returns>appsettings.json file path</returns>
-		/// <exception cref="ApplicationException">appsettings.json could not be found or created.</exception>
-		private static string getOrCreateAppsettingsFile()
-		{
-			const string appsettings_filename = "appsettings.json";
-
-			//Possible appsettings.json locations, in order of preference.
-			string[] possibleAppsettingsDirectories = new[]
-			{
-				ProcessDirectory,
-				LocalAppData,
-				UserProfile,
-				WinTemp,
-			};
-
-			//Try to find and validate appsettings.json in each folder
-			foreach (var dir in possibleAppsettingsDirectories)
-			{
-				var appsettingsFile = Path.Combine(dir, appsettings_filename);
-
-				if (File.Exists(appsettingsFile))
-				{
-					try
-					{
-						var appSettings = JObject.Parse(File.ReadAllText(appsettingsFile));
-
-						if (appSettings.ContainsKey(LIBATION_FILES_KEY)
-							&& appSettings[LIBATION_FILES_KEY] is JValue jval
-							&& jval.Value is string settingsPath
-							&& !string.IsNullOrWhiteSpace(settingsPath))
-							return appsettingsFile;
-					}
-					catch { }
-				}
-			}
-
-			//Valid appsettings.json not found. Try to create it in each folder.
-			var endingContents = new JObject { { LIBATION_FILES_KEY, DefaultLibationFilesDirectory } }.ToString(Formatting.Indented);
-
-			foreach (var dir in possibleAppsettingsDirectories)
-			{
-				//Don't try to create appsettings.json in the program files directory on *.nix systems.
-				//However, still _look_ for one there for backwards compatibility with previous installations
-				if (!IsWindows && dir == ProcessDirectory)
-					continue;
-
-				var appsettingsFile = Path.Combine(dir, appsettings_filename);
-
-				try
-				{
-					Directory.CreateDirectory(dir);
-					File.WriteAllText(appsettingsFile, endingContents);
-					return appsettingsFile;
-				}
-				catch(Exception ex)
-				{
-					Log.Logger.TryLogError(ex, $"Failed to create {appsettingsFile}");
-				}
-			}
-
-			throw new ApplicationException($"Could not locate or create {appsettings_filename}");
-		}
-
-		private static string getLibationFilesSettingFromJson()
-		{
-			// do not check whether directory exists. special/meta directory (eg: AppDir) is valid
-			// verify from live file. no try/catch. want failures to be visible
-			var jObjFinal = JObject.Parse(File.ReadAllText(AppsettingsJsonFile));
-
-			if (jObjFinal[LIBATION_FILES_KEY]?.Value<string>() is not string valueFinal)
-				throw new InvalidDataException($"{LIBATION_FILES_KEY} not found in {AppsettingsJsonFile}");
-
-			if (IsWindows)
-			{
-				valueFinal = Environment.ExpandEnvironmentVariables(valueFinal);
-			}
-			else
-			{
-				//If the shell command fails and returns null, proceed with the verbatim
-				//LIBATION_FILES_KEY path and hope for the best. If Libation can't find
-				//anything at this path it will set LIBATION_FILES_KEY to UserProfile
-				valueFinal = runShellCommand("echo " + valueFinal) ?? valueFinal;
-			}
-
-			return valueFinal;
-
-			static string? runShellCommand(string command)
-			{
-				var psi = new ProcessStartInfo
-				{
-					FileName = "/bin/sh",
-					RedirectStandardOutput = true,
-					UseShellExecute = false,
-					CreateNoWindow = true,
-					ArgumentList =
-					{
-						"-c",
-						command
-					}
-				};
-
-				try
-				{
-					var proc = Process.Start(psi);
-					proc?.WaitForExit();
-					return proc?.StandardOutput?.ReadToEnd()?.Trim();
-				}
-				catch (Exception e)
-				{
-					Serilog.Log.Error(e, "Failed to run shell command. {@Arguments}", psi.ArgumentList);
-					return null;
-				}
-			}
-		}
-
-        public static void SetLibationFiles(string directory)
-        {
-            LibationSettingsDirectory = null;
-
-            var startingContents = File.ReadAllText(AppsettingsJsonFile);
-            var jObj = JObject.Parse(startingContents);
-
-            jObj[LIBATION_FILES_KEY] = directory;
-
-            var endingContents = JsonConvert.SerializeObject(jObj, Formatting.Indented);
-            if (startingContents == endingContents)
-                return;
-
-            try
-            {
-                // now it's set in the file again but no settings have moved yet
-                File.WriteAllText(AppsettingsJsonFile, endingContents);
-
-				Log.Logger.TryLogInformation("Libation files changed {@DebugInfo}", new { AppsettingsJsonFile, LIBATION_FILES_KEY, directory });
-			}
-			catch (IOException ex)
-			{
-                Log.Logger.TryLogError(ex, "Failed to change Libation files location {@DebugInfo}", new { AppsettingsJsonFile, LIBATION_FILES_KEY, directory });
-			}
-		}
-    }
-}
diff --git a/Source/LibationFileManager/Configuration.Logging.cs b/Source/LibationFileManager/Configuration.Logging.cs
index ffbf9f2f..999d6e83 100644
--- a/Source/LibationFileManager/Configuration.Logging.cs
+++ b/Source/LibationFileManager/Configuration.Logging.cs
@@ -35,7 +35,7 @@ namespace LibationFileManager
                 typeof(FileLoggerConfigurationExtensions).Assembly);      // Serilog.Sinks.File
 
             configuration = new ConfigurationBuilder()
-                .AddJsonFile(SettingsFilePath, optional: false, reloadOnChange: true)
+                .AddJsonFile(Instance.LibationFiles.SettingsFilePath, optional: false, reloadOnChange: true)
                 .Build();
 			Log.Logger = new LoggerConfiguration()
 				 .ReadFrom.Configuration(configuration, readerOptions)
diff --git a/Source/LibationFileManager/Configuration.PersistentSettings.cs b/Source/LibationFileManager/Configuration.PersistentSettings.cs
index 5d758cdb..a3d2d98b 100644
--- a/Source/LibationFileManager/Configuration.PersistentSettings.cs
+++ b/Source/LibationFileManager/Configuration.PersistentSettings.cs
@@ -2,7 +2,6 @@
 using System.Collections.Generic;
 using System.ComponentModel;
 using System.Diagnostics.CodeAnalysis;
-using System.IO;
 using System.Linq;
 using System.Runtime.CompilerServices;
 using FileManager;
@@ -19,18 +18,16 @@ namespace LibationFileManager
 		// default setting and directory creation occur in class responsible for files.
 		// config class is only responsible for path. not responsible for setting defaults, dir validation, or dir creation
 		// exceptions: appsettings.json, LibationFiles dir, Settings.json
-
 		private IPersistentDictionary? persistentDictionary;
+		private IPersistentDictionary Settings => persistentDictionary
+			?? throw new InvalidOperationException($"{nameof(LoadPersistentSettings)} must first be called prior to accessing {nameof(Settings)}");
 
-		private IPersistentDictionary Settings
-		{
-			get
-			{
-				if (persistentDictionary is null)
-					throw new InvalidOperationException($"{nameof(persistentDictionary)} must first be set by accessing {nameof(LibationFiles)} or calling {nameof(SettingsFileIsValid)}");
-				return persistentDictionary;
-			}
-		}
+		internal void LoadPersistentSettings(string settingsFile)
+			=> persistentDictionary = new PersistentDictionary(settingsFile);
+
+		private LibationFiles? _libationFiles;
+		[Description("Location for storage of program-created files")]
+		public LibationFiles LibationFiles => _libationFiles ??= new LibationFiles();
 
 		public bool RemoveProperty(string propertyName) => Settings.RemoveProperty(propertyName);
 
@@ -80,8 +77,6 @@ namespace LibationFileManager
 				configuration?.Reload();
 		}
 
-		public string SettingsFilePath => Path.Combine(LibationFiles, "Settings.json");
-
 		public static string GetDescription(string propertyName)
 		{
 			var attribute = typeof(Configuration)
diff --git a/Source/LibationFileManager/Configuration.cs b/Source/LibationFileManager/Configuration.cs
index 55102a01..bae0f0a3 100644
--- a/Source/LibationFileManager/Configuration.cs
+++ b/Source/LibationFileManager/Configuration.cs
@@ -11,59 +11,16 @@ namespace LibationFileManager
 {
 	public partial class Configuration : PropertyChangeFilter
 	{
-		/// <summary>
-		/// Returns true if <see cref="SettingsFilePath"/> exists and the <see cref="Books"/> property has a non-null, non-empty value.
-		/// Does not verify the existence of the <see cref="Books"/> directory.
-		/// </summary>
-		public bool LibationSettingsAreValid => SettingsFileIsValid(SettingsFilePath);
-
-		/// <summary>
-		/// Returns true if <paramref name="settingsFile"/> exists and the <see cref="Books"/> property has a non-null, non-empty value.
-		/// Does not verify the existence of the <see cref="Books"/> directory.
-		/// </summary>
-		/// <param name="settingsFile">File path to the settings JSON file</param>
-		public static bool SettingsFileIsValid(string settingsFile)
-		{
-			if (!Directory.Exists(Path.GetDirectoryName(settingsFile)) || !File.Exists(settingsFile))
-				return false;
-
-			try
-			{
-				var settingsJson = JObject.Parse(File.ReadAllText(settingsFile));
-				return !string.IsNullOrWhiteSpace(settingsJson[nameof(Books)]?.Value<string>());
-			}
-			catch (Exception ex)
-			{
-				Serilog.Log.Logger.Error(ex, "Failed to load settings file: {@SettingsFile}", settingsFile);
-				try
-				{
-					Serilog.Log.Logger.Information("Deleting invalid settings file: {@SettingsFile}", settingsFile);
-					FileUtility.SaferDelete(settingsFile);
-					Serilog.Log.Logger.Information("Creating a new, empty setting file: {@SettingsFile}", settingsFile);
-					try
-					{
-						File.WriteAllText(settingsFile, "{}");
-					}
-					catch (Exception createEx)
-					{
-						Serilog.Log.Logger.Error(createEx, "Failed to create new settings file: {@SettingsFile}", settingsFile);
-					}
-				}
-				catch (Exception deleteEx)
-				{
-					Serilog.Log.Logger.Error(deleteEx, "Failed to delete the invalid settings file: {@SettingsFile}", settingsFile);
-				}
-
-				return false;
-			}
-		}
 
 		#region singleton stuff
 
-#if DEBUG
-
 		public static Configuration CreateMockInstance()
 		{
+#if !DEBUG
+			if (!new StackTrace().GetFrames().Select(f => f.GetMethod()?.DeclaringType?.Assembly.GetName().Name).Any(f => f?.EndsWith(".Tests") ?? false))
+				throw new InvalidOperationException($"Can only mock {nameof(Configuration)} in Debug mode or in test assemblies.");
+#endif
+
 			var mockInstance = new Configuration() { persistentDictionary = new MockPersistentDictionary() };
 			mockInstance.SetString("Light", "ThemeVariant");
 			Instance = mockInstance;
@@ -75,14 +32,7 @@ namespace LibationFileManager
 		}
 		private static readonly Configuration s_SingletonInstance = new();
 		public static Configuration Instance { get; private set; } = s_SingletonInstance;
-#else
 
-		public static Configuration CreateMockInstance()
-			=> throw new InvalidOperationException($"Can only mock {nameof(Configuration)} in Debug mode.");
-		public static void RestoreSingletonInstance()
-			=> throw new InvalidOperationException($"Can only mock {nameof(Configuration)} in Debug mode.");
-		public static Configuration Instance { get; } = new();
-#endif
 
 		private Configuration() { }
 		#endregion
diff --git a/Source/LibationFileManager/FilePathCache.cs b/Source/LibationFileManager/FilePathCache.cs
index 3cf6c528..5e2c2b27 100644
--- a/Source/LibationFileManager/FilePathCache.cs
+++ b/Source/LibationFileManager/FilePathCache.cs
@@ -19,7 +19,7 @@ namespace LibationFileManager
 		public static event EventHandler<CacheEntry>? Inserted;
 		public static event EventHandler<CacheEntry>? Removed;
 
-		private static LongPath jsonFileV2 => Path.Combine(Configuration.Instance.LibationFiles, FILENAME_V2);
+		private static LongPath jsonFileV2 => Path.Combine(Configuration.Instance.LibationFiles.Location, FILENAME_V2);
 
 		private static readonly FileCacheV2<CacheEntry> Cache = new();
 
diff --git a/Source/LibationFileManager/LibationFiles.cs b/Source/LibationFileManager/LibationFiles.cs
new file mode 100644
index 00000000..28d4bad0
--- /dev/null
+++ b/Source/LibationFileManager/LibationFiles.cs
@@ -0,0 +1,263 @@
+using Dinah.Core.Logging;
+using FileManager;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+using Serilog;
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("AppScaffolding")]
+[assembly: InternalsVisibleTo("LibationUiBase.Tests")]
+
+#nullable enable
+namespace LibationFileManager;	
+
+/// <summary>
+/// Provides access to Libation's configuration and settings file locations, including methods for validating and
+/// updating the Libation files directory and Settings.json file. An instance is bount to a single appsettings.json file.
+/// </summary>
+public  class LibationFiles
+{
+	internal static string? s_DefaultLibationFilesDirectory;
+	public static string DefaultLibationFilesDirectory => s_DefaultLibationFilesDirectory ??= Configuration.IsWindows ? Configuration.UserProfile : Configuration.LocalAppData;
+
+	public const string LIBATION_FILES_KEY = "LibationFiles";
+	public const string SETTINGS_JSON = "Settings.json";
+
+	/// <summary>
+	/// Directory pointed to by appsettings.json
+	/// </summary>
+	public LongPath Location { get; private set; }
+	/// <summary>
+	/// Returns true if <see cref="SettingsFilePath"/> exists and the <see cref="Configuration.Books"/> property has a non-null, non-empty value.
+	/// Does not verify the existence of the <see cref="Configuration.Books"/> directory.
+	/// </summary>
+	public bool SettingsAreValid => SettingsFileIsValid(SettingsFilePath);
+	/// <summary>
+	/// Found Location of appsettings.json. This file must exist or be able to be created for Libation to start.
+	/// </summary>
+	internal string AppsettingsJsonFile { get; }
+	/// <summary>
+	/// File path to Settings.json inside <see cref="Location"/>
+	/// </summary>
+	public string SettingsFilePath => Path.Combine(Location, SETTINGS_JSON);
+
+	internal LibationFiles() : this(GetOrCreateAppsettingsFile()) { }
+
+	internal LibationFiles(string appSettingsFile)
+	{
+		AppsettingsJsonFile = appSettingsFile;
+		Location = GetLibationFilesFromAppsettings(AppsettingsJsonFile);
+	}
+
+	/// <summary>
+	/// Set the location of the Libation Files directory, updating appsettings.json. 
+	/// </summary>
+	public void SetLibationFiles(LongPath libationFilesDirectory)
+	{
+		var startingContents = File.ReadAllText(AppsettingsJsonFile);
+		var jObj = JObject.Parse(startingContents);
+
+		jObj[LIBATION_FILES_KEY] = (string)(Location = libationFilesDirectory);
+
+		var endingContents = JsonConvert.SerializeObject(jObj, Formatting.Indented);
+		if (startingContents == endingContents)
+			return;
+
+		try
+		{
+			// now it's set in the file again but no settings have moved yet
+			File.WriteAllText(AppsettingsJsonFile, endingContents);
+			Log.Logger.TryLogInformation("Libation files changed {@DebugInfo}", new { AppsettingsJsonFile, LIBATION_FILES_KEY, libationFilesDirectory });
+		}
+		catch (Exception ex)
+		{
+			Log.Logger.TryLogError(ex, "Failed to change Libation files location {@DebugInfo}", new { AppsettingsJsonFile, LIBATION_FILES_KEY, libationFilesDirectory });
+		}
+	}
+
+	/// <summary>
+	/// Returns true if <paramref name="settingsFile"/> exists and the <see cref="Configuration.Books"/> property has a non-null, non-empty value.
+	/// Does not verify the existence of the <see cref="Configuration.Books"/> directory.
+	/// </summary>
+	/// <param name="settingsFile">File path to the Settings.json file</param>
+	public static bool SettingsFileIsValid(string settingsFile)
+	{
+		if (!Directory.Exists(Path.GetDirectoryName(settingsFile)) || !File.Exists(settingsFile))
+			return false;
+
+		try
+		{
+			var settingsJson = JObject.Parse(File.ReadAllText(settingsFile));
+			return !string.IsNullOrWhiteSpace(settingsJson[nameof(Configuration.Books)]?.Value<string>());
+		}
+		catch (Exception ex)
+		{
+			Log.Logger.Error(ex, "Failed to load settings file: {@SettingsFile}", settingsFile);
+			try
+			{
+				Log.Logger.Information("Deleting invalid settings file: {@SettingsFile}", settingsFile);
+				FileUtility.SaferDelete(settingsFile);
+				Log.Logger.Information("Creating a new, empty setting file: {@SettingsFile}", settingsFile);
+				try
+				{
+					File.WriteAllText(settingsFile, "{}");
+				}
+				catch (Exception createEx)
+				{
+					Log.Logger.Error(createEx, "Failed to create new settings file: {@SettingsFile}", settingsFile);
+				}
+			}
+			catch (Exception deleteEx)
+			{
+				Log.Logger.Error(deleteEx, "Failed to delete the invalid settings file: {@SettingsFile}", settingsFile);
+			}
+
+			return false;
+		}
+	}
+
+	/// <summary>
+	/// Try to find appsettings.json in the following locations:
+	///  <list type="number">
+	///		<item>
+	///			<description>[App Directory]</description>
+	///		</item>
+	///		<item>
+	///			<description>%LocalAppData%\Libation</description>
+	///		</item>
+	///		<item>
+	///			<description>%AppData%\Libation</description>
+	///		</item>
+	///		<item>
+	///			<description>%Temp%\Libation</description>
+	///		</item>
+	///  </list>   
+	///    
+	/// If not found, try to create it in each of the same locations in-order until successful.
+	///  
+	/// <para>This method must complete successfully for Libation to continue.</para>
+	/// </summary>
+	/// <returns>appsettings.json file path</returns>
+	/// <exception cref="ApplicationException">appsettings.json could not be found or created.</exception>
+	private static string GetOrCreateAppsettingsFile()
+	{
+		const string appsettings_filename = "appsettings.json";
+
+		//Possible appsettings.json locations, in order of preference.
+		string[] possibleAppsettingsDirectories = new[]
+		{
+				Configuration.ProcessDirectory,
+				Configuration.LocalAppData,
+				Configuration.UserProfile,
+				Configuration.WinTemp,
+			};
+
+		//Try to find and validate appsettings.json in each folder
+		foreach (var dir in possibleAppsettingsDirectories)
+		{
+			var appsettingsFile = Path.Combine(dir, appsettings_filename);
+
+			if (File.Exists(appsettingsFile))
+			{
+				try
+				{
+					var appSettings = JObject.Parse(File.ReadAllText(appsettingsFile));
+
+					if (appSettings.ContainsKey(LIBATION_FILES_KEY)
+						&& appSettings[LIBATION_FILES_KEY] is JValue jval
+						&& jval.Value is string settingsPath
+						&& !string.IsNullOrWhiteSpace(settingsPath))
+						return appsettingsFile;
+				}
+				catch { }
+			}
+		}
+
+		//Valid appsettings.json not found. Try to create it in each folder.
+		var endingContents = new JObject { { LIBATION_FILES_KEY, DefaultLibationFilesDirectory } }.ToString(Formatting.Indented);
+
+		foreach (var dir in possibleAppsettingsDirectories)
+		{
+			//Don't try to create appsettings.json in the program files directory on *.nix systems.
+			//However, still _look_ for one there for backwards compatibility with previous installations
+			if (!Configuration.IsWindows && dir == Configuration.ProcessDirectory)
+				continue;
+
+			var appsettingsFile = Path.Combine(dir, appsettings_filename);
+
+			try
+			{
+				Directory.CreateDirectory(dir);
+				File.WriteAllText(appsettingsFile, endingContents);
+				return appsettingsFile;
+			}
+			catch (Exception ex)
+			{
+				Log.Logger.TryLogError(ex, $"Failed to create {appsettingsFile}");
+			}
+		}
+
+		throw new ApplicationException($"Could not locate or create {appsettings_filename}");
+	}
+
+	/// <summary>
+	/// Get the LibationFiles directory from appsettings.json, expanding environment variables as needed.
+	/// </summary>
+	/// <param name="appsettingsPath"></param>
+	/// <returns></returns>
+	/// <exception cref="InvalidDataException">The appsettings.json file does not contain a "LibationFiles" key</exception>
+	private static string GetLibationFilesFromAppsettings(LongPath appsettingsPath)
+	{
+		// do not check whether directory exists. special/meta directory (eg: AppDir) is valid
+		// verify from live file. no try/catch. want failures to be visible
+		var jObjFinal = JObject.Parse(File.ReadAllText(appsettingsPath));
+
+		if (jObjFinal[LIBATION_FILES_KEY]?.Value<string>() is not string libationFiles)
+			throw new InvalidDataException($"{LIBATION_FILES_KEY} not found in {appsettingsPath}");
+
+		if (Configuration.IsWindows)
+		{
+			libationFiles = Environment.ExpandEnvironmentVariables(libationFiles);
+		}
+		else
+		{
+			//If the shell command fails and returns null, proceed with the verbatim
+			//LIBATION_FILES_KEY path and hope for the best. If Libation can't find
+			//anything at this path it will set LIBATION_FILES_KEY to UserProfile
+			libationFiles = runShellCommand("echo " + libationFiles) ?? libationFiles;
+		}
+
+		return libationFiles;
+
+		static string? runShellCommand(string command)
+		{
+			var psi = new ProcessStartInfo
+			{
+				FileName = "/bin/sh",
+				RedirectStandardOutput = true,
+				UseShellExecute = false,
+				CreateNoWindow = true,
+				ArgumentList =
+					{
+						"-c",
+						command
+					}
+			};
+
+			try
+			{
+				var proc = Process.Start(psi);
+				proc?.WaitForExit();
+				return proc?.StandardOutput?.ReadToEnd()?.Trim();
+			}
+			catch (Exception e)
+			{
+				Log.Error(e, "Failed to run shell command. {@Arguments}", psi.ArgumentList);
+				return null;
+			}
+		}
+	}
+}
diff --git a/Source/LibationFileManager/PictureStorage.cs b/Source/LibationFileManager/PictureStorage.cs
index dccd4d42..2ea746d9 100644
--- a/Source/LibationFileManager/PictureStorage.cs
+++ b/Source/LibationFileManager/PictureStorage.cs
@@ -43,7 +43,7 @@ namespace LibationFileManager
     {
         // not customizable. don't move to config
         private static string ImagesDirectory { get; }
-            = new DirectoryInfo(Configuration.Instance.LibationFiles).CreateSubdirectoryEx("Images").FullName;
+            = new DirectoryInfo(Configuration.Instance.LibationFiles.Location).CreateSubdirectoryEx("Images").FullName;
 
 		private static string getPath(PictureDefinition def)
 			=> Path.Combine(ImagesDirectory, $"{def.PictureId}{def.Size}.jpg");
diff --git a/Source/LibationFileManager/QuickFilters.cs b/Source/LibationFileManager/QuickFilters.cs
index 2f61082c..0255133f 100644
--- a/Source/LibationFileManager/QuickFilters.cs
+++ b/Source/LibationFileManager/QuickFilters.cs
@@ -20,7 +20,7 @@ namespace LibationFileManager
             public List<NamedFilter> Filters { get; set; } = new();
         }
 
-        public static string JsonFile => Path.Combine(Configuration.Instance.LibationFiles, "QuickFilters.json");
+        public static string JsonFile => Path.Combine(Configuration.Instance.LibationFiles.Location, "QuickFilters.json");
 
 
         // load json into memory. if file doesn't exist, nothing to do. save() will create if needed
diff --git a/Source/LibationFileManager/SqliteStorage.cs b/Source/LibationFileManager/SqliteStorage.cs
index fd98bf06..88fae1f1 100644
--- a/Source/LibationFileManager/SqliteStorage.cs
+++ b/Source/LibationFileManager/SqliteStorage.cs
@@ -5,7 +5,7 @@ namespace LibationFileManager
 	public static class SqliteStorage
 	{
 		// not customizable. don't move to config
-		private static string databasePath => Path.Combine(Configuration.Instance.LibationFiles, "LibationContext.db");
+		private static string databasePath => Path.Combine(Configuration.Instance.LibationFiles.Location, "LibationContext.db");
 		public static string ConnectionString => $"Data Source={databasePath};Foreign Keys=False;Pooling=False;";
 	}
 }
diff --git a/Source/LibationSearchEngine/SearchEngine.cs b/Source/LibationSearchEngine/SearchEngine.cs
index f1bd1075..3a3ee68e 100644
--- a/Source/LibationSearchEngine/SearchEngine.cs
+++ b/Source/LibationSearchEngine/SearchEngine.cs
@@ -280,6 +280,6 @@ namespace LibationSearchEngine
 
         // not customizable. don't move to config
         private static string SearchEngineDirectory { get; }
-            = new System.IO.DirectoryInfo(Configuration.Instance.LibationFiles).CreateSubdirectoryEx("SearchEngine").FullName;
+            = new System.IO.DirectoryInfo(Configuration.Instance.LibationFiles.Location).CreateSubdirectoryEx("SearchEngine").FullName;
     }
 }
diff --git a/Source/LibationUiBase/LibationSetup.cs b/Source/LibationUiBase/LibationSetup.cs
new file mode 100644
index 00000000..9d456e73
--- /dev/null
+++ b/Source/LibationUiBase/LibationSetup.cs
@@ -0,0 +1,242 @@
+using Dinah.Core;
+using Dinah.Core.Logging;
+using LibationFileManager;
+using LibationUiBase.Forms;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+using Serilog;
+using System;
+using System.IO;
+using System.Threading.Tasks;
+
+#nullable enable
+namespace LibationUiBase;
+
+/// <summary>
+/// Contains the results of a, initial setup prompt.
+/// </summary>
+public interface ILibationSetup
+{
+	public bool IsNewUser { get; }
+	public bool IsReturningUser { get; }
+}
+
+/// <summary>
+/// Contains the results of a Libation Files install location selection prompt.
+/// </summary>
+public interface ILibationInstallLocation
+{
+	public string? SelectedDirectory { get; }
+}
+
+/// <summary>
+/// Provides configuration and delegates for running the Libation setup process, including user prompts for initial
+/// setup and selecting installation locations.
+/// </summary>
+/// <remarks>LibationSetup encapsulates the logic required to ensure that Libation is properly configured before
+/// use. This class is used at application startup to ensure that all required settings are present and valid
+/// before proceeding.</remarks>
+public class LibationSetup
+{
+	/// <summary> Asynchronous delegate to show the setup prompt </summary>
+	public Func<Task<ILibationSetup>>? SetupPromptAsync { get; init; }
+	/// <summary> Asynchronous delegate to show the Libation Files selection dialog prompt </summary>
+	public Func<Task<ILibationInstallLocation?>>? SelectFolderPromptAsync { get; init; }
+	/// <summary> Synchronous delegate to show the setup prompt </summary>
+	public Func<ILibationSetup>? SetupPrompt { get; init; }
+	/// <summary> Synchronous delegate to show the Libation Files selection dialog prompt </summary>
+	public Func<ILibationInstallLocation?>? SelectFolderPrompt { get; init; }
+
+	private LibationFiles Files { get; }
+	public LibationSetup(LibationFiles libationFiles)
+	{
+		Files = libationFiles;
+	}
+
+	/// <summary>
+	/// Runs Libation setup if needed.
+	/// Verifies that 
+	/// </summary>
+	/// <returns></returns>
+	/// <exception cref="InvalidOperationException"></exception>
+	public async Task<bool> RunSetupIfNeededAsync()
+	{
+		// all returns should be preceded by either:
+		// - if libationFiles.LibationSettingsAreValid
+		// - OnCancelled()
+		if (Files.SettingsAreValid)
+			return true;
+
+		// check for existing settings in default location
+		// First check if file exists so that, if it doesn't, we don't
+		// overwrite user's LibationFiles setting in appsettings.json
+		var defaultSettingsFile = Path.Combine(LibationFiles.DefaultLibationFilesDirectory, LibationFiles.SETTINGS_JSON);
+		if (File.Exists(defaultSettingsFile) && LibationFiles.SettingsFileIsValid(defaultSettingsFile))
+		{
+			Files.SetLibationFiles(LibationFiles.DefaultLibationFilesDirectory);
+
+			if (Files.SettingsAreValid)
+				return true;
+		}
+
+		var setupResult
+			= SetupPromptAsync is not null ? await SetupPromptAsync()
+			: SetupPrompt is not null ? SetupPrompt()
+			: throw new InvalidOperationException("No setup prompt provided");
+
+		if (setupResult.IsNewUser)
+		{
+			return await CreateDefaultSettingsAsync();
+		}
+		else if (setupResult.IsReturningUser)
+		{
+			var chooseFolderResult
+				= SelectFolderPromptAsync is not null ? await SelectFolderPromptAsync()
+				: SelectFolderPrompt is not null ? SelectFolderPrompt()
+				: throw new InvalidOperationException("No select folder prompt provided");
+
+			if (string.IsNullOrWhiteSpace(chooseFolderResult?.SelectedDirectory))
+				return false;
+
+			Files.SetLibationFiles(chooseFolderResult.SelectedDirectory);
+			if (Files.SettingsAreValid)
+				return true;
+
+			// path did not result in valid settings
+			var continueResult = await MessageBoxBase.ShowAsyncImpl(null,
+				$"""
+				No valid settings were found at this location.				
+				Would you like to create a new install settings in this folder?
+				
+				{chooseFolderResult.SelectedDirectory}
+				""",				
+				"New install?",
+				MessageBoxButtons.YesNo,
+				MessageBoxIcon.Question,
+				MessageBoxDefaultButton.Button1);
+
+			return continueResult == DialogResult.Yes && await CreateDefaultSettingsAsync();
+		}
+		else
+		{
+			return false;
+		}
+	}
+
+	private async Task<bool> CreateDefaultSettingsAsync()
+	{
+		if (!TryCreateDirectory())
+		{
+			var result = await MessageBoxBase.ShowAsyncImpl(null,
+					$"""
+					Could not create the Libation Settings folder at:
+					{Files.Location.Path}
+					
+					Would you like to create a new install settings in this folder?
+					{LibationFiles.DefaultLibationFilesDirectory}
+					""",					
+					"Error Creating Libation Settings",
+					MessageBoxButtons.YesNo,
+					MessageBoxIcon.Question,
+					MessageBoxDefaultButton.Button1);
+
+			if (result is not DialogResult.Yes)
+				return false;
+
+			Files.SetLibationFiles(LibationFiles.DefaultLibationFilesDirectory);
+			//We should never not be able to access DefaultLibationFilesDirectory.
+			//If we can't write here, something is very wrong and we shouldn't even try to continue.
+			if (!TryCreateDirectory())
+			{
+				await MessageBoxBase.ShowAsyncImpl(null,
+					$"""
+					An error occurred while creating default settings folder:
+					{LibationFiles.DefaultLibationFilesDirectory}
+					""",					
+					"Error Creating Libation Settings",
+					MessageBoxButtons.OK,
+					MessageBoxIcon.Error,
+					MessageBoxDefaultButton.Button1);
+				return false;
+			}
+		}
+
+		if (Files.SettingsAreValid)
+			return true;
+
+		try
+		{
+			WriteDefaultSettingsFile(Files.SettingsFilePath);
+			return Files.SettingsAreValid;
+		}
+		catch (Exception ex)
+		{
+			// We are able to create the LibationFiles directory, but we can't write a settings file in it.
+			// Examples of this is the root of a system drive (C:\)
+			Log.Logger.TryLogError(ex, $"Failed to create {LibationFiles.SETTINGS_JSON} in {Files.Location}");
+
+
+			if (!Files.Location.PathWithoutPrefix.Equals(LibationFiles.DefaultLibationFilesDirectory, StringComparison.OrdinalIgnoreCase))
+			{
+				var result = await MessageBoxBase.ShowAsyncImpl(null,
+					$"""
+					Could not create the Libation Settings file at:
+					{Files.SettingsFilePath}
+					
+					Would you like to create a new install settings in this folder?
+					{LibationFiles.DefaultLibationFilesDirectory}
+					""",					
+					"Error Creating Libation Settings",
+					MessageBoxButtons.YesNo,
+					MessageBoxIcon.Question,
+					MessageBoxDefaultButton.Button1);
+
+				if (result is not DialogResult.Yes)
+					return false;
+
+				// Try again in the default location
+				Log.Logger.TryLogInformation($"Changing {LibationFiles.LIBATION_FILES_KEY} to {LibationFiles.DefaultLibationFilesDirectory}");
+				Files.SetLibationFiles(LibationFiles.DefaultLibationFilesDirectory);
+				return await CreateDefaultSettingsAsync();
+			}
+			else
+			{
+				await MessageBoxBase.ShowAsyncImpl(null,
+					$"""
+					An error occurred while creating default settings file in:
+					{LibationFiles.DefaultLibationFilesDirectory}
+					""",
+					"Error Creating Libation Settings",
+					MessageBoxButtons.OK,
+					MessageBoxIcon.Error,
+					MessageBoxDefaultButton.Button1);
+				return false;
+			}
+		}
+	}
+
+	private bool TryCreateDirectory()
+	{
+		try
+		{
+			Directory.CreateDirectory(Files.Location);
+			return true;
+		}
+		catch (Exception ex)
+		{
+			Log.Logger.TryLogError(ex, $"Failed to create {LibationFiles.LIBATION_FILES_KEY} directory at {Files.Location}");
+			return false;
+		}
+	}
+
+	private void WriteDefaultSettingsFile(string settingsFilePath)
+	{
+		var booksParent = Configuration.IsWindows ? Files.Location.Path : Configuration.MyMusic;
+		var jObj = new JObject
+		{
+			{ nameof(Configuration.Books), Path.Combine(booksParent, nameof(Configuration.Books)) }
+		};
+		var contents = JsonConvert.SerializeObject(jObj, Formatting.Indented);
+		File.WriteAllText(settingsFilePath, contents);
+	}
+}
diff --git a/Source/LibationWinForms/Dialogs/LibationFilesDialog.cs b/Source/LibationWinForms/Dialogs/LibationFilesDialog.cs
index a222a878..c20d02fa 100644
--- a/Source/LibationWinForms/Dialogs/LibationFilesDialog.cs
+++ b/Source/LibationWinForms/Dialogs/LibationFilesDialog.cs
@@ -1,10 +1,11 @@
-using System;
+using LibationFileManager;
+using LibationUiBase;
+using System;
 using System.Windows.Forms;
-using LibationFileManager;
 
 namespace LibationWinForms.Dialogs
 {
-	public partial class LibationFilesDialog : Form
+	public partial class LibationFilesDialog : Form, ILibationInstallLocation
 	{
 		public string SelectedDirectory { get; private set; }
 
@@ -26,7 +27,12 @@ namespace LibationWinForms.Dialogs
 				Configuration.KnownDirectories.AppDir,
 				Configuration.KnownDirectories.MyDocs
 			}, Configuration.KnownDirectories.UserProfile);
-			libationFilesSelectControl.SelectDirectory(config.LibationFiles);
+
+			var selectedDir = System.IO.Directory.Exists(Configuration.Instance.LibationFiles.Location.PathWithoutPrefix)
+				? Configuration.Instance.LibationFiles.Location.PathWithoutPrefix
+				: Configuration.GetKnownDirectoryPath(Configuration.KnownDirectories.UserProfile);
+
+			libationFilesSelectControl.SelectDirectory(selectedDir);
 		}
 
 		private void saveBtn_Click(object sender, EventArgs e)
diff --git a/Source/LibationWinForms/Dialogs/MessageBoxAlertAdminDialog.cs b/Source/LibationWinForms/Dialogs/MessageBoxAlertAdminDialog.cs
index 047fd1fc..896da325 100644
--- a/Source/LibationWinForms/Dialogs/MessageBoxAlertAdminDialog.cs
+++ b/Source/LibationWinForms/Dialogs/MessageBoxAlertAdminDialog.cs
@@ -58,7 +58,7 @@ namespace LibationWinForms.Dialogs
 				LongPath dir = "";
 				try
 				{
-					dir = LibationFileManager.Configuration.Instance.LibationFiles;
+					dir = LibationFileManager.Configuration.Instance.LibationFiles.Location;
 					Go.To.Folder(dir.ShortPathName);
 				}
 				catch
diff --git a/Source/LibationWinForms/Dialogs/SettingsDialog.Important.cs b/Source/LibationWinForms/Dialogs/SettingsDialog.Important.cs
index 54f137ee..d0295e9c 100644
--- a/Source/LibationWinForms/Dialogs/SettingsDialog.Important.cs
+++ b/Source/LibationWinForms/Dialogs/SettingsDialog.Important.cs
@@ -17,7 +17,7 @@ namespace LibationWinForms.Dialogs
 			if (File.Exists(LogFileFilter.LogFilePath))
 				Go.To.File(LogFileFilter.LogFilePath);
 			else
-				Go.To.Folder(((LongPath)Configuration.Instance.LibationFiles).ShortPathName);
+				Go.To.Folder(Configuration.Instance.LibationFiles.Location.ShortPathName);
 		}
 
 		private void Load_Important(Configuration config)
diff --git a/Source/LibationWinForms/Dialogs/SetupDialog.cs b/Source/LibationWinForms/Dialogs/SetupDialog.cs
index f863da84..2f01c342 100644
--- a/Source/LibationWinForms/Dialogs/SetupDialog.cs
+++ b/Source/LibationWinForms/Dialogs/SetupDialog.cs
@@ -1,10 +1,11 @@
-using System;
+using LibationUiBase;
+using System;
 using System.Linq;
 using System.Windows.Forms;
 
 namespace LibationWinForms.Dialogs
 {
-	public partial class SetupDialog : Form
+	public partial class SetupDialog : Form, ILibationSetup
 	{
 		public bool IsNewUser { get; private set; }
 		public bool IsReturningUser { get; private set; }
diff --git a/Source/LibationWinForms/Program.cs b/Source/LibationWinForms/Program.cs
index 12c49b6f..a3e8abd1 100644
--- a/Source/LibationWinForms/Program.cs
+++ b/Source/LibationWinForms/Program.cs
@@ -1,14 +1,16 @@
+using ApplicationServices;
+using AppScaffolding;
+using DataLayer;
+using Dinah.Core.WindowsDesktop.Processes;
+using LibationFileManager;
+using LibationUiBase;
+using LibationWinForms.Dialogs;
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 using System.Windows.Forms;
-using ApplicationServices;
-using AppScaffolding;
-using DataLayer;
-using LibationFileManager;
-using LibationWinForms.Dialogs;
 
 namespace LibationWinForms
 {
@@ -18,8 +20,10 @@ namespace LibationWinForms
 		[return: System.Runtime.InteropServices.MarshalAs(System.Runtime.InteropServices.UnmanagedType.Bool)]
 		static extern bool AllocConsole();
 
+		private static Form1 form1;
+
 		[STAThread]
-		static void Main()
+		static async Task Main()
 		{
 			Task<List<LibraryBook>> libraryLoadTask;
 
@@ -41,9 +45,10 @@ namespace LibationWinForms
 				//***********************************************//
 				// Migrations which must occur before configuration is loaded for the first time. Usually ones which alter the Configuration
 				var config = AppScaffolding.LibationScaffolding.RunPreConfigMigrations();
+				LibationUiBase.Forms.MessageBoxBase.ShowAsyncImpl = ShowMessageBox;
 
 				// do this as soon as possible (post-config)
-				RunInstaller(config);
+				await RunSetupIfNeededAsync(config);
 
 				// most migrations go in here
 				LibationScaffolding.RunPostConfigMigrations(config);
@@ -87,103 +92,60 @@ namespace LibationWinForms
 
 			var form1 = new Form1();
 			form1.Load += async (_, _) => await form1.InitLibraryAsync(await libraryLoadTask);
-			LibationUiBase.Forms.MessageBoxBase.ShowAsyncImpl = ShowMessageBox;
 			Application.Run(form1);
-
-			#region Message Box Handler for LibationUiBase
-			Task<LibationUiBase.Forms.DialogResult> ShowMessageBox(
-				object owner,
-				string message,
-				string caption,
-				LibationUiBase.Forms.MessageBoxButtons buttons,
-				LibationUiBase.Forms.MessageBoxIcon icon,
-				LibationUiBase.Forms.MessageBoxDefaultButton defaultButton,
-				bool _)
-			{
-				var result = form1.Invoke(() =>
-					MessageBox.Show(
-						owner as IWin32Window ?? form1,
-						message,
-						caption,
-						(MessageBoxButtons)buttons,
-						(MessageBoxIcon)icon,
-						(MessageBoxDefaultButton)defaultButton));
-
-				return Task.FromResult((LibationUiBase.Forms.DialogResult)result);
-			}
-			#endregion;
 		}
 
-		private static void RunInstaller(Configuration config)
+		#region Message Box Handler for LibationUiBase
+		static Task<LibationUiBase.Forms.DialogResult> ShowMessageBox(
+			object owner,
+			string message,
+			string caption,
+			LibationUiBase.Forms.MessageBoxButtons buttons,
+			LibationUiBase.Forms.MessageBoxIcon icon,
+			LibationUiBase.Forms.MessageBoxDefaultButton defaultButton,
+			bool _)
 		{
-			// all returns should be preceded by either:
-			// - if config.LibationSettingsAreValid
-			// - error message, Exit()
+			Func<DialogResult> showMessageBox = () => MessageBox.Show(
+					owner as IWin32Window ?? form1,
+					message,
+					caption,
+					(MessageBoxButtons)buttons,
+					(MessageBoxIcon)icon,
+					(MessageBoxDefaultButton)defaultButton);
 
-			if (config.LibationSettingsAreValid)
-				return;
 
-			var defaultLibationFilesDir = Configuration.DefaultLibationFilesDirectory;
+			var result = form1 is null ? showMessageBox() : form1.Invoke(showMessageBox);
+			return Task.FromResult((LibationUiBase.Forms.DialogResult)result);
+		}
+		#endregion;
 
-			// check for existing settings in default location
-			// First check if file exists so that, if it doesn't, we don't
-			// overwrite user's LibationFiles setting in appsettings.json
-			var defaultSettingsFile = Path.Combine(defaultLibationFilesDir, "Settings.json");
-			if (File.Exists(defaultSettingsFile) && Configuration.SettingsFileIsValid(defaultSettingsFile))
-				Configuration.SetLibationFiles(defaultLibationFilesDir);
+		private static async Task RunSetupIfNeededAsync(Configuration config)
+		{
+			var setup = new LibationSetup(config.LibationFiles)
+			{
+				SetupPrompt = ShowSetup,
+				SelectFolderPrompt = SelectInstallLocation
+			};
 
-			if (config.LibationSettingsAreValid)
-				return;
-
-			static void CancelInstallation()
+			if (!await setup.RunSetupIfNeededAsync())
 			{
 				MessageBox.Show("Initial set up cancelled.", "Cancelled", MessageBoxButtons.OK, MessageBoxIcon.Warning);
 				Application.Exit();
-				Environment.Exit(0);
+				Environment.Exit(-1);
 			}
 
-			var setupDialog = new SetupDialog();
-			if (setupDialog.ShowDialog() != DialogResult.OK)
+			static ILibationSetup ShowSetup()
 			{
-				CancelInstallation();
-				return;
+				var setupDialog = new SetupDialog();
+				setupDialog.ShowDialog();
+				return setupDialog;
 			}
 
-			if (setupDialog.IsNewUser)
-			{
-				config.Books = Configuration.DefaultBooksDirectory;
-			}
-			else if (setupDialog.IsReturningUser)
+			static ILibationInstallLocation SelectInstallLocation()
 			{
 				var libationFilesDialog = new LibationFilesDialog();
-
-				if (libationFilesDialog.ShowDialog() != DialogResult.OK)
-				{
-					CancelInstallation();
-					return;
-				}
-
-				Configuration.SetLibationFiles(libationFilesDialog.SelectedDirectory);
-				if (config.LibationSettingsAreValid)
-					return;
-
-				// path did not result in valid settings
-				var continueResult = MessageBox.Show(
-					$"No valid settings were found at this location.\r\nWould you like to create a new install settings in this folder?\r\n\r\n{libationFilesDialog.SelectedDirectory}",
-					"New install?",
-					MessageBoxButtons.YesNo,
-					MessageBoxIcon.Question);
-
-				if (continueResult != DialogResult.Yes)
-				{
-					CancelInstallation();
-					return;
-				}
-				config.Books = Configuration.DefaultBooksDirectory;
+				return libationFilesDialog.ShowDialog() is DialogResult.OK ? libationFilesDialog : null;
 			}
-
-			if (!config.LibationSettingsAreValid)
-				CancelInstallation();
 		}
 
 		/// <summary>migrations which require Forms or are long-running</summary>
diff --git a/Source/_Tests/LibationFileManager.Tests/TemplatesTests.cs b/Source/_Tests/LibationFileManager.Tests/TemplatesTests.cs
index ce77b342..8c823700 100644
--- a/Source/_Tests/LibationFileManager.Tests/TemplatesTests.cs
+++ b/Source/_Tests/LibationFileManager.Tests/TemplatesTests.cs
@@ -23,13 +23,9 @@ namespace TemplatesTests
 
 	public static class Shared
 	{
-		[System.Runtime.CompilerServices.ModuleInitializer]
-		public static void Init()
+		static Shared()
 		{
-			var thisDir = Path.GetDirectoryName(Environment.ProcessPath);
-			LibationFileManager.Configuration.SetLibationFiles(thisDir);
-			if (!LibationFileManager.Configuration.Instance.LibationSettingsAreValid)
-				LibationFileManager.Configuration.Instance.Books = Path.Combine(thisDir, "Books");
+			LibationFileManager.Configuration.CreateMockInstance().Books = Path.GetFullPath("Books");
 		}
 
 		public static LibraryBookDto GetLibraryBook()
diff --git a/Source/_Tests/LibationUiBase.Tests/LibationFilesTest.cs b/Source/_Tests/LibationUiBase.Tests/LibationFilesTest.cs
new file mode 100644
index 00000000..fd6d8239
--- /dev/null
+++ b/Source/_Tests/LibationUiBase.Tests/LibationFilesTest.cs
@@ -0,0 +1,255 @@
+using LibationFileManager;
+using LibationUiBase.Forms;
+using Newtonsoft.Json.Linq;
+
+namespace LibationUiBase.Tests;
+
+[TestClass]
+public class LibationFilesTest
+{
+	//Mock MessageBox results in setup workflow
+	private Queue<DialogResult> MessageBoxResults { get; } = new();
+	private Task<DialogResult> ShowMessageBox(
+			object? owner,
+			string message,
+			string caption,
+			MessageBoxButtons buttons,
+			MessageBoxIcon icon,
+			MessageBoxDefaultButton defaultButton,
+			bool _)
+		=> Task.FromResult(MessageBoxResults.Dequeue());
+
+	public LibationFilesTest()
+	{
+		MessageBoxBase.ShowAsyncImpl = ShowMessageBox;
+	}
+
+	[TestMethod]
+	public async Task Setup_NoSelection()
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings());
+		var setup = CreateMockSetup(libationFiles, isNewUser: false, isReturningUser: false, selectedDirectory: null);
+
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task Setup_NoSelection_SettingsExistInDefaultLocation()
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings());
+		var setup = CreateMockSetup(libationFiles, isNewUser: false, isReturningUser: false, selectedDirectory: null);
+
+		File.WriteAllText(Path.Combine(LibationFiles.DefaultLibationFilesDirectory, LibationFiles.SETTINGS_JSON), new JObject { { "Books", "SomePath" } }.ToString());
+		Assert.IsTrue(await setup.RunSetupIfNeededAsync());
+		Assert.IsTrue(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task NewInstall_BadLibationFilesPath_ChooseDefault_Yes()
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings(BadPath));
+		var setup = CreateMockSetup(libationFiles, isNewUser: true, isReturningUser: false, selectedDirectory: null);
+
+		//Error Creating LibationFiles. Move to default directory? 
+		MessageBoxResults.Enqueue(DialogResult.Yes);
+
+		Assert.IsTrue(await setup.RunSetupIfNeededAsync());
+		Assert.IsTrue(libationFiles.SettingsAreValid);
+	}
+
+	private static string BadPath => Configuration.IsWindows ? "NONEXISTANT:\\" : "/NONEXISTANT";
+	[TestMethod]
+	public async Task NewInstall_BadLibationFilesPath_ChooseDefault_Yes_Fail()
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings(BadPath));
+		var setup = CreateMockSetup(libationFiles, isNewUser: true, isReturningUser: false, selectedDirectory: null);
+
+		LibationFiles.s_DefaultLibationFilesDirectory = Path.Combine(BadPath, "AlsoInvalid");
+
+		//Error Creating LibationFiles. Move to default directory? 
+		MessageBoxResults.Enqueue(DialogResult.Yes);
+		MessageBoxResults.Enqueue(DialogResult.OK);
+
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task NewInstall_BadLibationFilesPath_ChooseDefault_No()
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings(BadPath));
+		var setup = CreateMockSetup(libationFiles, isNewUser: true, isReturningUser: false, selectedDirectory: null);
+
+		//Error Creating LibationFiles. Move to default directory? 
+		MessageBoxResults.Enqueue(DialogResult.No);
+
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task NewInstall_ReadonlyDir_DefaultDir()
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings());
+		var setup = CreateMockSetup(libationFiles, isNewUser: true, isReturningUser: false, selectedDirectory: null);
+		MakeUnixReadOnly(Directory.CreateDirectory(libationFiles.Location));
+
+		//Dismiss error creating settings file MBox
+		MessageBoxResults.Enqueue(DialogResult.OK);
+
+		//Prevent installer from being able to create settings file
+		using var fs = Configuration.IsWindows ? File.Open(libationFiles.SettingsFilePath, FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read) : default(IDisposable);
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task NewInstall_ReadonlyDir_CustomDir_RevertToDefault_No()
+	{
+		var customDir = Path.GetFullPath("CustomDir");
+		if (Directory.Exists(customDir))
+			Directory.Delete(customDir, recursive: true);
+		MakeUnixReadOnly(Directory.CreateDirectory(customDir));
+
+		var libationFiles = new LibationFiles(CreateAppSettings(customDir));
+		var setup = CreateMockSetup(libationFiles, isNewUser: true, isReturningUser: false, selectedDirectory: null);
+
+		//Error Creating Settings.json. Move to default directory? 
+		MessageBoxResults.Enqueue(DialogResult.No);
+		//Prevent installer from being able to create settings file in customDir
+
+		using var fs = Configuration.IsWindows ? File.Open(Path.Combine(customDir, LibationFiles.SETTINGS_JSON), FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read) : default(IDisposable);
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task NewInstall_ReadonlyDir_CustomDir_RevertToDefault_Yes()
+	{
+		var customDir = Path.GetFullPath("CustomDir");
+		if (Directory.Exists(customDir))
+			Directory.Delete(customDir, recursive: true);
+		Directory.CreateDirectory(customDir);
+
+		var libationFiles = new LibationFiles(CreateAppSettings(customDir));
+		var setup = CreateMockSetup(libationFiles, isNewUser: true, isReturningUser: false, selectedDirectory: null);
+
+		//Error Creating Settings.json. Move to default directory? 
+		MessageBoxResults.Enqueue(DialogResult.Yes);
+		//Prevent installer from being able to create settings file in customDir
+		using var fs = File.Open(Path.Combine(customDir, LibationFiles.SETTINGS_JSON), FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read);
+		Assert.IsTrue(await setup.RunSetupIfNeededAsync());
+		Assert.IsTrue(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	[DataRow(null)]
+	[DataRow("")]
+	[DataRow("   ")]
+	public async Task Returning_BadSelectedDir(string? selectedDir)
+	{
+		var libationFiles = new LibationFiles(CreateAppSettings());
+		var setup = CreateMockSetup(libationFiles, isNewUser: false, isReturningUser: true, selectedDir);
+
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task Returning_SettingsFound()
+	{
+		var customDir = Path.GetFullPath("CustomDir");
+		if (Directory.Exists(customDir))
+			Directory.Delete(customDir, recursive: true);
+		Directory.CreateDirectory(customDir);
+
+		var libationFiles = new LibationFiles(CreateAppSettings());
+		var setup = CreateMockSetup(libationFiles, isNewUser: false, isReturningUser: true, selectedDirectory: customDir);
+
+		File.WriteAllText(Path.Combine(customDir, LibationFiles.SETTINGS_JSON), new JObject { { "Books", "SomePath" } }.ToString());
+		Assert.IsTrue(await setup.RunSetupIfNeededAsync());
+		Assert.IsTrue(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task Returning_SettingsNotFound_CreateAt_Yes()
+	{
+		var customDir = Path.GetFullPath("CustomDir");
+		if (Directory.Exists(customDir))
+			Directory.Delete(customDir, recursive: true);
+		Directory.CreateDirectory(customDir);
+
+		var libationFiles = new LibationFiles(CreateAppSettings());
+		var setup = CreateMockSetup(libationFiles, isNewUser: false, isReturningUser: true, selectedDirectory: customDir);
+
+		//No valid settings were found. Create New Install? 
+		MessageBoxResults.Enqueue(DialogResult.Yes);
+
+		Assert.IsTrue(await setup.RunSetupIfNeededAsync());
+		Assert.IsTrue(libationFiles.SettingsAreValid);
+	}
+
+	[TestMethod]
+	public async Task Returning_SettingsNotFound_CreateAt_No()
+	{
+		var customDir = Path.GetFullPath("CustomDir");
+		if (Directory.Exists(customDir))
+			Directory.Delete(customDir, recursive: true);
+		Directory.CreateDirectory(customDir);
+		var appSettingsFile = CreateAppSettings();
+		var libationFiles = new LibationFiles(appSettingsFile);
+
+		var setup = CreateMockSetup(libationFiles, isNewUser: false, isReturningUser: true, selectedDirectory: customDir);
+
+		//No valid settings were found. Create New Install? 
+		MessageBoxResults.Enqueue(DialogResult.No);
+		Assert.IsFalse(await setup.RunSetupIfNeededAsync());
+	}
+
+	private LibationSetup CreateMockSetup(LibationFiles libationFiles, bool isNewUser, bool isReturningUser, string? selectedDirectory)
+	{
+		Assert.IsTrue(File.Exists(libationFiles.AppsettingsJsonFile));
+		Assert.IsFalse(libationFiles.SettingsAreValid);
+		return new LibationSetup(libationFiles)
+		{
+			SetupPrompt = () => new MockLibationSetup { IsNewUser = isNewUser, IsReturningUser = isReturningUser },
+			SelectFolderPrompt = () => new MockLibationInstallLocation { SelectedDirectory = selectedDirectory}
+		};
+	}
+	private static void MakeUnixReadOnly(FileSystemInfo di)
+	{
+#pragma warning disable CA1416 // Validate platform compatibility
+		if (!Configuration.IsWindows)
+			di.UnixFileMode &= ~(UnixFileMode.UserWrite | UnixFileMode.GroupWrite | UnixFileMode.OtherWrite);
+#pragma warning restore CA1416
+	}
+
+	private class MockLibationSetup : ILibationSetup
+	{
+		public bool IsNewUser { get; set; }
+		public bool IsReturningUser { get; set; }
+	}
+
+	private class MockLibationInstallLocation : ILibationInstallLocation
+	{
+		public string? SelectedDirectory { get; set; }
+	}
+
+	private static string CreateAppSettings(string? libationFiles = null)
+	{
+		var file = Path.GetFullPath($"appsettings.test.json");
+
+		var libationFilesDir = Path.Combine(Environment.CurrentDirectory, "LibationFilesTest");
+		if (Directory.Exists(libationFilesDir))
+			Directory.Delete(libationFilesDir, recursive: true);
+		Directory.CreateDirectory(libationFilesDir);
+		LibationFiles.s_DefaultLibationFilesDirectory = libationFilesDir;
+
+		if (File.Exists(file))
+			File.Delete(file);
+		File.WriteAllText(file, new JObject { { LibationFiles.LIBATION_FILES_KEY, libationFiles ?? libationFilesDir } }.ToString());
+
+		return file;
+	}
+}
diff --git a/Source/_Tests/LibationUiBase.Tests/LibationUiBase.Tests.csproj b/Source/_Tests/LibationUiBase.Tests/LibationUiBase.Tests.csproj
new file mode 100644
index 00000000..84b20b39
--- /dev/null
+++ b/Source/_Tests/LibationUiBase.Tests/LibationUiBase.Tests.csproj
@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net9.0</TargetFramework>
+    <LangVersion>latest</LangVersion>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
+    <PackageReference Include="MSTest" Version="3.6.4" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\LibationUiBase\LibationUiBase.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Using Include="Microsoft.VisualStudio.TestTools.UnitTesting" />
+  </ItemGroup>
+
+</Project>

From 65d24ce223babd3d43f246af7ca177f36179a6e5 Mon Sep 17 00:00:00 2001
From: Michael Bucari-Tovo <mbucari1@gmail.com>
Date: Mon, 17 Nov 2025 10:53:58 -0700
Subject: [PATCH 15/18] Fix NRE in FileSystemTest when Books dir is invalid
 (#1435)

---
 Source/FileManager/FileSystemTest.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/Source/FileManager/FileSystemTest.cs b/Source/FileManager/FileSystemTest.cs
index eef4ea28..c8be82bf 100644
--- a/Source/FileManager/FileSystemTest.cs
+++ b/Source/FileManager/FileSystemTest.cs
@@ -1,6 +1,7 @@
 using System;
 using System.IO;
 
+#nullable enable
 namespace FileManager
 {
 	public static class FileSystemTest
@@ -15,8 +16,10 @@ namespace FileManager
 		/// <summary>
 		/// Test if the directory supports filenames with characters that are invalid on Windows (:, *, ?, &lt;, &gt;, |).
 		/// </summary>
-		public static bool CanWriteWindowsInvalidChars(LongPath directoryName)
+		public static bool CanWriteWindowsInvalidChars(LongPath? directoryName)
 		{
+			if (directoryName is null)
+				return false;
 			var testFile = Path.Combine(directoryName, AdditionalInvalidWindowsFilenameCharacters + Guid.NewGuid().ToString());
 			return CanWriteFile(testFile);
 		}
@@ -24,8 +27,10 @@ namespace FileManager
 		/// <summary>
 		/// Test if the directory supports filenames with 255 unicode characters.
 		/// </summary>
-		public static bool CanWrite255UnicodeChars(LongPath directoryName)
+		public static bool CanWrite255UnicodeChars(LongPath? directoryName)
 		{
+			if (directoryName is null)
+				return false;
 			const char unicodeChar = 'ü';
 			var testFileName = new string(unicodeChar, 255);
 			var testFile = Path.Combine(directoryName, testFileName);

From ce2b81036fe6d4a3aaf3c06ba2ae7ac2b4816e34 Mon Sep 17 00:00:00 2001
From: MBucari <mbucari1@gmail.com>
Date: Mon, 17 Nov 2025 22:49:30 -0700
Subject: [PATCH 16/18] Add license and settings overrides to LibationCli

- Add `LIBATION_FILES_DIR` environment variable to specify LibationFiles directory instead of appsettings.json
- OptionsBase supports overriding setting
  - Added `EphemeralSettings` which are loaded from Settings.json once and can be modified with the `--override` command parameter
- Added `get-setting` command
  - Prints (editable) settings and their values. Prints specified settings, or all settings if none specified
  - `--listEnumValues` option will list all names for a speficied enum-type settings. If no setting names are specified, prints all enum values for all enum settings.
  - Prints in a text-based table or bare with `-b` switch
- Added `get-license` command which requests a content license and prints it as a json to stdout
- Improved `liberate` command
  - Added `-force` option to force liberation without validation.
  - Added support to download with a license file supplied to stdin
  - Improve startup performance when downloading explicit ASIN(s)
  - Fix long-standing bug where cover art was not being downloading
---
 Source/AaxDecrypter/IDownloadOptions.cs       |   1 +
 Source/AppScaffolding/LibationScaffolding.cs  |  12 +-
 .../AppScaffolding/UNSAFE_MigrationHelper.cs  |  45 +--
 .../QueryObjects/LibraryBookQueries.cs        |  15 +-
 Source/FileLiberator/DownloadDecryptBook.cs   |   9 +-
 .../FileLiberator/DownloadOptions.Factory.cs  |  27 +-
 ...Dictionary.cs => IJsonBackedDictionary.cs} |   2 +-
 Source/FileManager/PersistentDictionary.cs    |   4 +-
 Source/LibationAvalonia/Program.cs            |   2 +-
 Source/LibationCli/Options/CopyDbOptions.cs   |  10 +-
 .../LibationCli/Options/GetLicenseOptions.cs  |  66 +++++
 .../LibationCli/Options/GetSettingOptions.cs  | 140 +++++++++
 Source/LibationCli/Options/LiberateOptions.cs |  84 +++++-
 .../Options/SetDownloadStatusOptions.cs       |   2 +-
 Source/LibationCli/Options/_OptionsBase.cs    | 205 ++++++++++++-
 .../Options/_ProcessableOptionsBase.cs        |  65 +++-
 Source/LibationCli/Program.cs                 |  15 +-
 Source/LibationCli/Setup.cs                   |  22 +-
 Source/LibationCli/TextTableExtention.cs      | 277 ++++++++++++++++++
 .../Configuration.Logging.cs                  |   4 +-
 .../Configuration.PersistentSettings.cs       |  10 +-
 Source/LibationFileManager/Configuration.cs   |   2 +-
 ...ntDictionary.cs => EphemeralDictionary.cs} |  15 +-
 Source/LibationFileManager/LibationFiles.cs   |  23 +-
 Source/LibationWinForms/Program.cs            |   4 +-
 25 files changed, 956 insertions(+), 105 deletions(-)
 rename Source/FileManager/{IPersistentDictionary.cs => IJsonBackedDictionary.cs} (97%)
 create mode 100644 Source/LibationCli/Options/GetLicenseOptions.cs
 create mode 100644 Source/LibationCli/Options/GetSettingOptions.cs
 create mode 100644 Source/LibationCli/TextTableExtention.cs
 rename Source/LibationFileManager/{MockPersistentDictionary.cs => EphemeralDictionary.cs} (80%)

diff --git a/Source/AaxDecrypter/IDownloadOptions.cs b/Source/AaxDecrypter/IDownloadOptions.cs
index 11e79db8..7f1199c3 100644
--- a/Source/AaxDecrypter/IDownloadOptions.cs
+++ b/Source/AaxDecrypter/IDownloadOptions.cs
@@ -15,6 +15,7 @@ namespace AaxDecrypter
             KeyPart2 = keyPart2;
         }
 
+        [Newtonsoft.Json.JsonConstructor]
         public KeyData(string keyPart1, string? keyPart2 = null)
         {
             ArgumentNullException.ThrowIfNull(keyPart1, nameof(keyPart1));
diff --git a/Source/AppScaffolding/LibationScaffolding.cs b/Source/AppScaffolding/LibationScaffolding.cs
index 4514869c..7ab25d22 100644
--- a/Source/AppScaffolding/LibationScaffolding.cs
+++ b/Source/AppScaffolding/LibationScaffolding.cs
@@ -79,9 +79,17 @@ namespace AppScaffolding
 		}
 
 		/// <summary>most migrations go in here</summary>
-		public static void RunPostConfigMigrations(Configuration config)
+		public static void RunPostConfigMigrations(Configuration config, bool ephemeralSettings = false)
 		{
-			config.LoadPersistentSettings(config.LibationFiles.SettingsFilePath);
+			if (ephemeralSettings)
+			{
+				var settings = JObject.Parse(File.ReadAllText(config.LibationFiles.SettingsFilePath));
+				config.LoadEphemeralSettings(settings);
+			}
+			else
+			{
+				config.LoadPersistentSettings(config.LibationFiles.SettingsFilePath);
+			}
 			AudibleApiStorage.EnsureAccountsSettingsFileExists();
 
 			//
diff --git a/Source/AppScaffolding/UNSAFE_MigrationHelper.cs b/Source/AppScaffolding/UNSAFE_MigrationHelper.cs
index 89597ab5..1df02c43 100644
--- a/Source/AppScaffolding/UNSAFE_MigrationHelper.cs
+++ b/Source/AppScaffolding/UNSAFE_MigrationHelper.cs
@@ -7,6 +7,7 @@ using LibationFileManager;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
 
+#nullable enable
 namespace AppScaffolding
 {
 	/// <summary>
@@ -20,21 +21,21 @@ namespace AppScaffolding
 	/// </summary>
 	public static class UNSAFE_MigrationHelper
 	{
-		public static string SettingsDirectory
+		public static string? SettingsDirectory
 			=> !APPSETTINGS_TryGet(LibationFiles.LIBATION_FILES_KEY, out var value) || value is null
 			? null
 			: value;
 
 		#region appsettings.json
 
-		public static bool APPSETTINGS_TryGet(string key, out string value)
+		public static bool APPSETTINGS_TryGet(string key, out string? value)
 		{
 			bool success = false;
-			JToken val = null;
+			JToken? val = null;
 
 			process_APPSETTINGS_Json(jObj => success = jObj.TryGetValue(key, out val), false);
 
-			value = success ? val.Value<string>() : null;
+			value = success ? val?.Value<string>() : null;
 			return success;
 		}
 
@@ -59,7 +60,10 @@ namespace AppScaffolding
 		/// <param name="save">True: save if contents changed. False: no not attempt save</param>
 		private static void process_APPSETTINGS_Json(Action<JObject> action, bool save = true)
 		{
-			var startingContents = File.ReadAllText(Configuration.Instance.LibationFiles.AppsettingsJsonFile);
+			if (Configuration.Instance.LibationFiles.AppsettingsJsonFile is not string appSettingsFile)
+				return;
+
+			var startingContents = File.ReadAllText(appSettingsFile);
 
 			JObject jObj;
 			try
@@ -88,32 +92,31 @@ namespace AppScaffolding
 		#endregion
 		#region Settings.json
 
-		public static string SettingsJsonPath => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LibationFiles.SETTINGS_JSON);
-		public static bool SettingsJson_Exists => SettingsJsonPath is not null && File.Exists(SettingsJsonPath);
+		public static string? SettingsJsonPath => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LibationFiles.SETTINGS_JSON);
 
-		public static bool Settings_TryGet(string key, out string value)
+		public static bool Settings_TryGet(string key, out string? value)
 		{
 			bool success = false;
-			JToken val = null;
+			JToken? val = null;
 
 			process_SettingsJson(jObj => success = jObj.TryGetValue(key, out val), false);
 
-			value = success ? val.Value<string>() : null;
+			value = success ? val?.Value<string>() : null;
 			return success;
 		}
 
 		public static bool Settings_JsonPathIsType(string jsonPath, JTokenType jTokenType)
 		{
-			JToken val = null;
+			JToken? val = null;
 
 			process_SettingsJson(jObj => val = jObj.SelectToken(jsonPath), false);
 
 			return val?.Type == jTokenType;
 		}
 
-		public static bool Settings_TryGetFromJsonPath(string jsonPath, out string value)
+		public static bool Settings_TryGetFromJsonPath(string jsonPath, out string? value)
 		{
-			JToken val = null;
+			JToken? val = null;
 
 			process_SettingsJson(jObj => val = jObj.SelectToken(jsonPath), false);
 
@@ -155,10 +158,10 @@ namespace AppScaffolding
 			if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
 				return false;
 
-			JArray array = null;
-			process_SettingsJson(jObj => array = (JArray)jObj.SelectToken(jsonPath));
+			JArray? array = null;
+			process_SettingsJson(jObj => array = jObj.SelectToken(jsonPath) as JArray);
 
-			length = array.Count;
+			length = array?.Count ?? 0;
 			return true;
 		}
 
@@ -169,8 +172,7 @@ namespace AppScaffolding
 
 			process_SettingsJson(jObj =>
 			{
-				var array = (JArray)jObj.SelectToken(jsonPath);
-				array.Add(newValue);
+				(jObj.SelectToken(jsonPath) as JArray)?.Add(newValue);
 			});
 		}
 
@@ -198,8 +200,7 @@ namespace AppScaffolding
 
 			process_SettingsJson(jObj =>
 			{
-				var array = (JArray)jObj.SelectToken(jsonPath);
-				if (position < array.Count)
+				if (jObj.SelectToken(jsonPath) is JArray array && position < array.Count)
 					array.RemoveAt(position);
 			});
 		}
@@ -226,7 +227,7 @@ namespace AppScaffolding
 		private static void process_SettingsJson(Action<JObject> action, bool save = true)
 		{
 			// only insert if not exists
-			if (!SettingsJson_Exists)
+			if (!File.Exists(SettingsJsonPath))
 				return;
 
 			var startingContents = File.ReadAllText(SettingsJsonPath);
@@ -258,7 +259,7 @@ namespace AppScaffolding
 		#endregion
 		#region LibationContext.db
 		public const string LIBATION_CONTEXT = "LibationContext.db";
-		public static string DatabaseFile => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LIBATION_CONTEXT);
+		public static string? DatabaseFile => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LIBATION_CONTEXT);
 		public static bool DatabaseFile_Exists => DatabaseFile is not null && File.Exists(DatabaseFile);
 		#endregion
 	}
diff --git a/Source/DataLayer/QueryObjects/LibraryBookQueries.cs b/Source/DataLayer/QueryObjects/LibraryBookQueries.cs
index 4a3e60e1..5a2275ab 100644
--- a/Source/DataLayer/QueryObjects/LibraryBookQueries.cs
+++ b/Source/DataLayer/QueryObjects/LibraryBookQueries.cs
@@ -25,16 +25,17 @@ namespace DataLayer
 				.Where(c => !c.Book.IsEpisodeParent() || includeParents)
 				.ToList();
 
-        public static LibraryBook? GetLibraryBook_Flat_NoTracking(this LibationContext context, string productId)
-            => context
+        public static LibraryBook? GetLibraryBook_Flat_NoTracking(this LibationContext context, string productId, bool caseSensative = true)
+        {
+            var libraryQuery
+                = context
                 .LibraryBooks
                 .AsNoTrackingWithIdentityResolution()
-                .GetLibraryBook(productId);
+                .GetLibrary();
 
-        public static LibraryBook? GetLibraryBook(this IQueryable<LibraryBook> library, string productId)
-            => library
-                .GetLibrary()
-                .SingleOrDefault(lb => lb.Book.AudibleProductId == productId);
+            return caseSensative ? libraryQuery.SingleOrDefault(lb => lb.Book.AudibleProductId == productId)
+                : libraryQuery.SingleOrDefault(lb => EF.Functions.Collate(lb.Book.AudibleProductId, "NOCASE") == productId);
+		}
 
         /// <summary>This is still IQueryable. YOU MUST CALL ToList() YOURSELF</summary>
         public static IQueryable<LibraryBook> GetLibrary(this IQueryable<LibraryBook> library)
diff --git a/Source/FileLiberator/DownloadDecryptBook.cs b/Source/FileLiberator/DownloadDecryptBook.cs
index de4d35d1..eeaf06c0 100644
--- a/Source/FileLiberator/DownloadDecryptBook.cs
+++ b/Source/FileLiberator/DownloadDecryptBook.cs
@@ -23,6 +23,11 @@ namespace FileLiberator
 		private CancellationTokenSource? cancellationTokenSource;
 		private AudiobookDownloadBase? abDownloader;
 
+		/// <summary>
+		/// Optional override to supply license info directly instead of querying the api based on Configuration options
+		/// </summary>
+		public DownloadOptions.LicenseInfo? LicenseInfo { get; set; }
+
 		public override bool Validate(LibraryBook libraryBook) => !libraryBook.Book.Audio_Exists();
 		public override async Task CancelAsync()
 		{
@@ -44,7 +49,9 @@ namespace FileLiberator
 				DownloadValidation(libraryBook);
 
 				var api = await libraryBook.GetApiAsync();
-				using var downloadOptions = await DownloadOptions.InitiateDownloadAsync(api, Configuration.Instance, libraryBook, cancellationToken);
+
+				LicenseInfo ??= await DownloadOptions.GetDownloadLicenseAsync(api, libraryBook, Configuration.Instance, cancellationToken);
+				using var downloadOptions = DownloadOptions.BuildDownloadOptions(libraryBook, Configuration.Instance, LicenseInfo);
 				var result = await DownloadAudiobookAsync(api, downloadOptions, cancellationToken);
 
 				if (!result.Success || getFirstAudioFile(result.ResultFiles) is not TempFile audioFile)
diff --git a/Source/FileLiberator/DownloadOptions.Factory.cs b/Source/FileLiberator/DownloadOptions.Factory.cs
index 9d4215b6..4c1a8eb4 100644
--- a/Source/FileLiberator/DownloadOptions.Factory.cs
+++ b/Source/FileLiberator/DownloadOptions.Factory.cs
@@ -4,9 +4,9 @@ using AudibleApi.Common;
 using AudibleUtilities.Widevine;
 using DataLayer;
 using Dinah.Core;
-using DocumentFormat.OpenXml.Wordprocessing;
 using LibationFileManager;
 using NAudio.Lame;
+using Newtonsoft.Json;
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -21,9 +21,9 @@ namespace FileLiberator;
 public partial class DownloadOptions
 {
 	/// <summary>
-	/// Initiate an audiobook download from the audible api.
+	/// Requests a download license from the Api using the Configuration settings to choose the appropriate content.
 	/// </summary>
-	public static async Task<DownloadOptions> InitiateDownloadAsync(Api api, Configuration config, LibraryBook libraryBook, CancellationToken token)
+	public static async Task<LicenseInfo> GetDownloadLicenseAsync(Api api, LibraryBook libraryBook, Configuration config, CancellationToken token)
 	{
 		var license = await ChooseContent(api, libraryBook, config, token);
 		Serilog.Log.Logger.Debug("Content License {@License}", new
@@ -65,14 +65,20 @@ public partial class DownloadOptions
 			license.ContentMetadata.ChapterInfo = metadata.ChapterInfo;
 
 		token.ThrowIfCancellationRequested();
-		return BuildDownloadOptions(libraryBook, config, license);
+		return license;
 	}
 
-	private class LicenseInfo
+	public class LicenseInfo
 	{
-		public DrmType DrmType { get; }
-		public ContentMetadata ContentMetadata { get; }
-		public KeyData[]? DecryptionKeys { get; }
+		public DrmType DrmType { get; set; }
+		public ContentMetadata ContentMetadata { get; set; }
+		public KeyData[]? DecryptionKeys { get; set; }
+
+		[JsonConstructor]
+		private LicenseInfo()
+		{
+			ContentMetadata = null!;
+		}
 		public LicenseInfo(ContentLicense license, IEnumerable<KeyData>? keys = null)
 		{
 			DrmType = license.DrmType;
@@ -159,7 +165,10 @@ public partial class DownloadOptions
 		}
 	}
 
-	private static DownloadOptions BuildDownloadOptions(LibraryBook libraryBook, Configuration config, LicenseInfo licInfo)
+	/// <summary>
+	/// Builds DownloadOptions from the given LibraryBook, Configuration, and LicenseInfo.
+	/// </summary>
+	public static DownloadOptions BuildDownloadOptions(LibraryBook libraryBook, Configuration config, LicenseInfo licInfo)
 	{
 		long chapterStartMs
 			= config.StripAudibleBrandAudio
diff --git a/Source/FileManager/IPersistentDictionary.cs b/Source/FileManager/IJsonBackedDictionary.cs
similarity index 97%
rename from Source/FileManager/IPersistentDictionary.cs
rename to Source/FileManager/IJsonBackedDictionary.cs
index 865733d1..ad508588 100644
--- a/Source/FileManager/IPersistentDictionary.cs
+++ b/Source/FileManager/IJsonBackedDictionary.cs
@@ -5,7 +5,7 @@ using System.Linq;
 #nullable enable
 namespace FileManager;
 
-public interface IPersistentDictionary
+public interface IJsonBackedDictionary
 {
 	bool Exists(string propertyName);
 	string? GetString(string propertyName, string? defaultValue = null);
diff --git a/Source/FileManager/PersistentDictionary.cs b/Source/FileManager/PersistentDictionary.cs
index 9bc86746..94f8012b 100644
--- a/Source/FileManager/PersistentDictionary.cs
+++ b/Source/FileManager/PersistentDictionary.cs
@@ -8,7 +8,7 @@ using Newtonsoft.Json.Linq;
 #nullable enable
 namespace FileManager
 {
-    public class PersistentDictionary : IPersistentDictionary
+    public class PersistentDictionary : IJsonBackedDictionary
     {
         public string Filepath { get; }
         public bool IsReadOnly { get; }
@@ -59,7 +59,7 @@ namespace FileManager
                 objectCache[propertyName] = defaultValue;
                 return defaultValue;
             }
-            return IPersistentDictionary.UpCast<T>(obj);
+            return IJsonBackedDictionary.UpCast<T>(obj);
 		}
 
         public object? GetObject(string propertyName)
diff --git a/Source/LibationAvalonia/Program.cs b/Source/LibationAvalonia/Program.cs
index d0c7a3ec..d2179412 100644
--- a/Source/LibationAvalonia/Program.cs
+++ b/Source/LibationAvalonia/Program.cs
@@ -105,7 +105,7 @@ namespace LibationAvalonia
 			try
 			{
 				//Try to log the error message before displaying the crash dialog
-				if (Configuration.Instance.LoggingEnabled)
+				if (Configuration.Instance.SerilogInitialized)
 					Serilog.Log.Logger.Error(exception, "CRASH");
 				else
 					LogErrorWithoutSerilog(exception);
diff --git a/Source/LibationCli/Options/CopyDbOptions.cs b/Source/LibationCli/Options/CopyDbOptions.cs
index 3dc728ee..dd7c5fdb 100644
--- a/Source/LibationCli/Options/CopyDbOptions.cs
+++ b/Source/LibationCli/Options/CopyDbOptions.cs
@@ -6,15 +6,15 @@ using System;
 using System.Linq;
 using System.Threading.Tasks;
 
+#nullable enable
 namespace LibationCli
 {
     [Verb("copydb", HelpText = "Copy the local sqlite database to postgres.")]
     public class CopyDbOptions : OptionsBase
-    {
-        [Option(shortName: 'c', longName: "connectionString")]
-        public string PostgresConnectionString { get; set; }
-
-        protected override async Task ProcessAsync()
+	{
+		[Option(shortName: 'c', longName: "connectionString", HelpText = "Postgres Database connection string")]
+		public string? PostgresConnectionString { get; set; }
+		protected override async Task ProcessAsync()
         {
             var srcConnectionString = SqliteStorage.ConnectionString;
             var destConnectionString = PostgresConnectionString ?? Configuration.Instance.PostgresqlConnectionString;
diff --git a/Source/LibationCli/Options/GetLicenseOptions.cs b/Source/LibationCli/Options/GetLicenseOptions.cs
new file mode 100644
index 00000000..ea8296c8
--- /dev/null
+++ b/Source/LibationCli/Options/GetLicenseOptions.cs
@@ -0,0 +1,66 @@
+using ApplicationServices;
+using CommandLine;
+using DataLayer;
+using FileLiberator;
+using LibationFileManager;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+using System;
+using System.Threading.Tasks;
+
+#nullable enable
+namespace LibationCli.Options;
+
+[Verb("get-license", HelpText = "Get the license information for a book.")]
+internal class GetLicenseOptions : OptionsBase
+{
+
+	[Value(0, MetaName = "[asin]", HelpText = "Product ID of book to request license for.", Required = true)]
+	public string? Asin { get; set; }
+	protected override async Task ProcessAsync()
+	{
+		if (string.IsNullOrWhiteSpace(Asin))
+		{
+			Console.Error.WriteLine("ASIN is required.");
+			return;
+		}
+
+		using var dbContext = DbContexts.GetContext();
+		if (dbContext.GetLibraryBook_Flat_NoTracking(Asin) is not LibraryBook libraryBook)
+		{
+			Console.Error.WriteLine($"Book not found with asin={Asin}");
+			return;
+		}
+
+		var api = await libraryBook.GetApiAsync();
+		var license = await DownloadOptions.GetDownloadLicenseAsync(api, libraryBook, Configuration.Instance, default);
+		
+		var jsonSettings = new JsonSerializerSettings
+		{
+			NullValueHandling = NullValueHandling.Ignore,
+			Converters = [new StringEnumConverter(), new ByteArrayHexConverter()]
+		};
+
+		var licenseJson = JsonConvert.SerializeObject(license, Formatting.Indented, jsonSettings);
+		Console.WriteLine(licenseJson);
+	}
+}
+
+class ByteArrayHexConverter : JsonConverter
+{
+	public override bool CanConvert(Type objectType) => objectType == typeof(byte[]);
+
+	public override bool CanRead => false;
+	public override bool CanWrite => true;
+
+	public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
+		=> throw new NotSupportedException();
+
+	public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
+	{
+		if (value is byte[] array)
+		{
+			writer.WriteValue(Convert.ToHexStringLower(array));
+		}
+	}
+}
diff --git a/Source/LibationCli/Options/GetSettingOptions.cs b/Source/LibationCli/Options/GetSettingOptions.cs
new file mode 100644
index 00000000..b9de10ff
--- /dev/null
+++ b/Source/LibationCli/Options/GetSettingOptions.cs
@@ -0,0 +1,140 @@
+using CommandLine;
+using Dinah.Core;
+using FileManager;
+using LibationFileManager;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Reflection;
+using System.Threading.Tasks;
+
+#nullable enable
+namespace LibationCli.Options;
+
+[Verb("get-setting", HelpText = "List current settings files and their locations.")]
+internal class GetSettingOptions : OptionsBase
+{
+	[Option('l', "listEnumValues", HelpText = "List all value possibilities of enum types")]
+	public bool ListEnumValues { get; set; }
+
+	[Option('b', "bare", HelpText = "Print bare list without table decoration")]
+	public bool Bare { get; set; }
+
+	[Value(0, MetaName = "[setting names]", HelpText = "Optional names of settings to get.")]
+	public IEnumerable<string>? SettingNames { get; set; }
+
+	protected override Task ProcessAsync()
+	{
+		var configs = GetConfigOptions();
+		if (SettingNames?.Any() is true)
+		{
+			//Operate over listed settings
+			foreach (var item in SettingNames.ExceptBy(configs.Select(c => c.Name), c => c, StringComparer.OrdinalIgnoreCase))
+			{
+				Console.Error.WriteLine($"Unknown Setting Name: {item}");
+			}
+
+			var validSettings = configs.IntersectBy(SettingNames, a => a.Name, StringComparer.OrdinalIgnoreCase);
+			if (ListEnumValues)
+			{
+				foreach (var item in validSettings.Where(s => !s.SettingType.IsEnum))
+				{
+					Console.Error.WriteLine($"Setting '{item.Name}' is not an enum type");
+				}
+
+				PrintEnumValues(validSettings.Where(s => s.SettingType.IsEnum));
+			}
+			else
+			{
+				PrintConfigOption(validSettings);
+			}
+		}
+		else
+		{
+			//Operate over all settings
+			if (ListEnumValues)
+			{
+				PrintEnumValues(configs);
+			}
+			else
+			{
+				PrintConfigOption(configs);
+			}
+		}
+		return Task.CompletedTask;
+	}
+
+	private void PrintConfigOption(IEnumerable<ConfigOption> options)
+	{
+		if (Bare)
+		{
+			foreach (var option in options)
+			{
+				Console.WriteLine($"{option.Name}={option.Value}");
+			}
+		}
+		else
+		{
+			Console.Out.DrawTable(options, new(), o => o.Name, o => o.Value, o => o.Type);
+		}
+	}
+
+	private void PrintEnumValues(IEnumerable<ConfigOption> options)
+	{
+		foreach (var item in options.Where(s => s.SettingType.IsEnum))
+		{
+			var enumValues = Enum.GetNames(item.SettingType);
+			if (Bare)
+			{
+				Console.WriteLine(string.Join(Environment.NewLine, enumValues.Select(e => $"{item.Name}.{e}")));
+			}
+			else
+			{
+				Console.Out.DrawTable(enumValues, new TextTableOptions(), new ColumnDef<string>(item.Name, t => t));
+			}
+		}
+	}
+
+	private ConfigOption[] GetConfigOptions()
+	{
+		var configs = GetConfigurationProperties().Where(o=> o.PropertyType != typeof(ReplacementCharacters)).Select(p => new ConfigOption(p));
+		var replacements = GetConfigurationProperties().SingleOrDefault(o => o.PropertyType == typeof(ReplacementCharacters))?.GetValue(Configuration.Instance) as ReplacementCharacters;
+
+		if (replacements is not null)
+		{
+			//Don't reorder after concat to keep replacements grouped together at the bottom
+			configs = configs.Concat(replacements.Replacements.Select(r => new ConfigOption(r)));
+		}
+
+		return configs.ToArray();
+	}
+
+	private record EnumOption(string EnumOptionValue);
+	private record ConfigOption
+	{
+		public string Name { get; }
+		public string Type { get; }
+		public Type SettingType { get; }
+		public string Value { get; }
+		public ConfigOption(PropertyInfo propertyInfo)
+		{
+			Name = propertyInfo.Name;
+			SettingType = propertyInfo.PropertyType;
+			Type = GetTypeString(SettingType);
+			Value = propertyInfo.GetValue(Configuration.Instance)?.ToString() is not string value ? "[null]"
+				: SettingType == typeof(string) || SettingType == typeof(LongPath) ? value.SurroundWithQuotes()
+				: value;
+		}
+
+		public ConfigOption(Replacement replacement)
+		{
+			Name = GetReplacementName(replacement);
+			SettingType = typeof(string);
+			Type = GetTypeString(SettingType);
+			Value = replacement.ReplacementString.SurroundWithQuotes();
+		}
+
+		private static string GetTypeString(Type type)
+		=> type.IsEnum ? $"{type.Name} (enum)": type.Name;
+	}
+}
diff --git a/Source/LibationCli/Options/LiberateOptions.cs b/Source/LibationCli/Options/LiberateOptions.cs
index 9f8fdf63..0ff87aaa 100644
--- a/Source/LibationCli/Options/LiberateOptions.cs
+++ b/Source/LibationCli/Options/LiberateOptions.cs
@@ -1,44 +1,108 @@
-using CommandLine;
+using ApplicationServices;
+using CommandLine;
 using DataLayer;
 using FileLiberator;
+using LibationCli.Options;
 using LibationFileManager;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
 using System;
+using System.IO;
 using System.Threading.Tasks;
 
+#nullable enable
 namespace LibationCli
 {
-	[Verb("liberate", HelpText = "Liberate: book and pdf backups. Default: download and decrypt all un-liberated titles and download pdfs. "
-		+ "Optional: use 'pdf' flag to only download pdfs.")]
+	[Verb("liberate", HelpText = "Liberate: book and pdf backups. Default: download and decrypt all un-liberated titles and download pdfs.\n"
+		+ "Optional: specify asin(s) of book(s) to liberate.\n"
+		+ "Optional: reads a license file from standard input.")]
 	public class LiberateOptions : ProcessableOptionsBase
 	{
 		[Option(shortName: 'p', longName: "pdf", Required = false, Default = false, HelpText = "Flag to only download pdfs")]
 		public bool PdfOnly { get; set; }
 
-		protected override Task ProcessAsync()
+		[Option(shortName: 'f', longName: "force", Required = false, Default = false, HelpText = "Force the book to re-download")]
+		public bool Force { get; set; }
+
+		protected override async Task ProcessAsync()
 		{
 			if (AudibleFileStorage.BooksDirectory is null)
 			{
 				Console.Error.WriteLine("Error: Books directory is not set. Please configure the 'Books' setting in Settings.json.");
-				return Task.CompletedTask;
+				return;
 			}
 
-			return PdfOnly
-			? RunAsync(CreateProcessable<DownloadPdf>())
-			: RunAsync(CreateBackupBook());
+			if (Console.IsInputRedirected)
+			{
+				Console.WriteLine("Reading license file from standard input.");
+				using var reader = new StreamReader(Console.OpenStandardInput());
+				var stdIn = await reader.ReadToEndAsync();
+				try
+				{
+
+					var jsonSettings = new JsonSerializerSettings
+					{
+						NullValueHandling = NullValueHandling.Ignore,
+						Converters = [new StringEnumConverter(), new ByteArrayHexConverter()]
+					};
+					var licenseInfo = JsonConvert.DeserializeObject<DownloadOptions.LicenseInfo>(stdIn, jsonSettings);
+
+					if (licenseInfo?.ContentMetadata?.ContentReference?.Asin is not string asin)
+					{
+						Console.Error.WriteLine("Error: License file is missing ASIN information.");
+						return;
+					}
+
+					LibraryBook libraryBook;
+					using (var dbContext = DbContexts.GetContext())
+					{
+						if (dbContext.GetLibraryBook_Flat_NoTracking(asin) is not LibraryBook lb)
+						{
+							Console.Error.WriteLine($"Book not found with asin={asin}");
+							return;
+						}
+						libraryBook = lb;
+					}
+
+					SetDownloadedStatus(libraryBook);
+					await ProcessOneAsync(GetProcessable(licenseInfo), libraryBook, true);
+				}
+				catch
+				{
+					Console.Error.WriteLine("Error: Failed to read license file from standard input. Please ensure the input is a valid license file in JSON format.");
+				}
+			}
+			else
+			{
+				await RunAsync(GetProcessable(), SetDownloadedStatus);
+			}
 		}
 
-		private static Processable CreateBackupBook()
+		private Processable GetProcessable(DownloadOptions.LicenseInfo? licenseInfo = null)
+			=> PdfOnly ? CreateProcessable<DownloadPdf>() : CreateBackupBook(licenseInfo);
+
+		private void SetDownloadedStatus(LibraryBook lb)
+		{
+			if (Force)
+			{
+				lb.Book.UserDefinedItem.BookStatus = LiberatedStatus.NotLiberated;
+				lb.Book.UserDefinedItem.SetPdfStatus(LiberatedStatus.NotLiberated);
+			}
+		}
+
+		private static Processable CreateBackupBook(DownloadOptions.LicenseInfo? licenseInfo)
 		{
 			var downloadPdf = CreateProcessable<DownloadPdf>();
 
 			//Chain pdf download on DownloadDecryptBook.Completed
-			void onDownloadDecryptBookCompleted(object sender, LibraryBook e)
+			void onDownloadDecryptBookCompleted(object? sender, LibraryBook e)
 			{
 				// this is fast anyway. run as sync for easy exception catching
 				downloadPdf.TryProcessAsync(e).GetAwaiter().GetResult();
 			}
 
 			var downloadDecryptBook = CreateProcessable<DownloadDecryptBook>(onDownloadDecryptBookCompleted);
+			downloadDecryptBook.LicenseInfo = licenseInfo;
 			return downloadDecryptBook;
 		}
 	}
diff --git a/Source/LibationCli/Options/SetDownloadStatusOptions.cs b/Source/LibationCli/Options/SetDownloadStatusOptions.cs
index 4205542a..b563c152 100644
--- a/Source/LibationCli/Options/SetDownloadStatusOptions.cs
+++ b/Source/LibationCli/Options/SetDownloadStatusOptions.cs
@@ -21,7 +21,7 @@ namespace LibationCli
 		[Option(shortName: 'n', longName: "not-downloaded", Group = "Download Status", HelpText = "set download status to 'Not Downloaded'")]
 		public bool SetNotDownloaded { get; set; }
 
-		[Option("force", HelpText = "Set the download status regardless of whether the book's audio file can be found. Only one download status option may be used with this option.")]
+		[Option('f', "force", HelpText = "Set the download status regardless of whether the book's audio file can be found. Only one download status option may be used with this option.")]
 		public bool Force { get; set; }
 
 		[Value(0, MetaName = "[asins]", HelpText = "Optional product IDs of books on which to set download status.")]
diff --git a/Source/LibationCli/Options/_OptionsBase.cs b/Source/LibationCli/Options/_OptionsBase.cs
index cce3f0ee..5aecac9f 100644
--- a/Source/LibationCli/Options/_OptionsBase.cs
+++ b/Source/LibationCli/Options/_OptionsBase.cs
@@ -1,15 +1,44 @@
 using CommandLine;
+using CsvHelper.TypeConversion;
+using Dinah.Core;
+using FileManager;
+using LibationFileManager;
 using System;
+using System.Collections.Generic;
+using System.ComponentModel;
 using System.IO;
+using System.Linq;
 using System.Reflection;
 using System.Threading.Tasks;
 
+#nullable enable
 namespace LibationCli
 {
 	public abstract class OptionsBase
 	{
+		[Option(longName: "libationFiles", HelpText = "Path to Libation Files directory")]
+		public DirectoryInfo? LibationFiles { get; set; }
+
+		[Option('o', "override",  HelpText = "Configuration setting override", MetaValue = "[SettingName]=\"Setting_Value\"")]
+		public IEnumerable<OptionOverride>? SettingOverrides { get; set; }
+
 		public async Task Run()
 		{
+			if (LibationFiles?.Exists is true)
+			{
+				Environment.SetEnvironmentVariable(LibationFileManager.LibationFiles.LIBATION_FILES_DIR, LibationFiles.FullName);
+			}
+
+			//***********************************************//
+			//                                               //
+			//   do not use Configuration before this line   //
+			//                                               //
+			//***********************************************//
+			Setup.Initialize();
+
+			if (SettingOverrides is not null)
+				ProcessSettingsOverrides();
+
 			try
 			{
 				await ProcessAsync();
@@ -17,20 +46,39 @@ namespace LibationCli
 			catch (Exception ex)
 			{
 				Environment.ExitCode = (int)ExitCode.RunTimeError;
-				PrintVerbUsage(new string[]
-				{
+				PrintVerbUsage(
 					"ERROR",
 					"=====",
 					ex.Message,
 					"",
-					ex.StackTrace
-				});
+					ex.StackTrace);
 			}
 		}
 
-		protected void PrintVerbUsage(params string[] linesBeforeUsage)
+		private static bool TryParseEnum(Type enumType, string? value, out object? result)
 		{
-			var verb = GetType().GetCustomAttribute<VerbAttribute>().Name;
+			var values = Enum.GetNames(enumType);
+
+			if (values.Select(n => n.ToLowerInvariant()).Distinct().Count() != values.Length)
+			{
+				//Enum names must be case sensitive.
+				return Enum.TryParse(enumType, value, out result);
+			}
+
+			for (int i = 0; i < values.Length; i++)
+			{
+				if (values[i].Equals(value, StringComparison.OrdinalIgnoreCase))
+				{
+					return Enum.TryParse(enumType, values[i], out result);
+				}
+			}
+			result = null;
+			return false;
+		}
+
+		protected void PrintVerbUsage(params string?[] linesBeforeUsage)
+		{
+			var verb = GetType().GetCustomAttribute<VerbAttribute>()?.Name;
 			var helpText = new HelpVerb { HelpType = verb }.GetHelpText();
 			helpText.AddPreOptionsLines(linesBeforeUsage);
 			helpText.AddPreOptionsLine("");
@@ -46,5 +94,150 @@ namespace LibationCli
 		}
 
 		protected abstract Task ProcessAsync();
+
+		protected IOrderedEnumerable<PropertyInfo> GetConfigurationProperties()
+			=> typeof(Configuration).GetProperties(BindingFlags.Instance | BindingFlags.Public)
+			.Where(p => p.CustomAttributes.Any(a => a.AttributeType == typeof(DescriptionAttribute)))
+			.Where(p => !p.Name.In(ExcludedSettings))
+			.OrderBy(p => p.PropertyType.IsEnum)
+			.ThenBy(p => p.PropertyType.Name)
+			.ThenBy(p => p.Name);
+
+		private readonly string[] ExcludedSettings = [
+			nameof(Configuration.LibationFiles),
+			nameof(Configuration.GridScaleFactor),
+			nameof(Configuration.GridFontScaleFactor),
+			nameof(Configuration.GridColumnsVisibilities),
+			nameof(Configuration.GridColumnsDisplayIndices),
+			nameof(Configuration.GridColumnsWidths)];
+
+		private void ProcessSettingsOverrides()
+		{
+			var configProperties = GetConfigurationProperties().ToArray();
+			foreach (var option in SettingOverrides?.Where(p => p.Property is not null && p.Value is not null) ?? [])
+			{
+				if (option.Property?.StartsWithInsensitive(ReplacePrefix) is true)
+				{
+					OverrideReplacement(option);
+				}
+				else if (configProperties.FirstOrDefault(p => p.Name.EqualsInsensitive(option.Property)) is not PropertyInfo property)
+				{
+					Console.Error.WriteLine($"Unknown configuration property '{option.Property}'");
+				}
+				else if (property.PropertyType == typeof(string))
+				{
+					property.SetValue(Configuration.Instance, option.Value?.Trim());
+				}
+				else if (property.PropertyType == typeof(bool) && bool.TryParse(option.Value?.Trim(), out var bVal))
+				{
+					property.SetValue(Configuration.Instance, bVal);
+				}
+				else if (property.PropertyType == typeof(int) && int.TryParse(option.Value?.Trim(), out var intVal))
+				{
+					property.SetValue(Configuration.Instance, intVal);
+				}
+				else if (property.PropertyType == typeof(long) && long.TryParse(option.Value?.Trim(), out var longVal))
+				{
+					property.SetValue(Configuration.Instance, longVal);
+				}
+				else if (property.PropertyType == typeof(LongPath))
+				{
+					var value = option.Value is null ? null : (LongPath)option.Value.Trim();
+					property.SetValue(Configuration.Instance, value);
+				}
+				else if (property.PropertyType.IsEnum && TryParseEnum(property.PropertyType, option.Value?.Trim(), out var enumVal))
+				{
+					property.SetValue(Configuration.Instance, enumVal);
+				}
+				else
+				{
+					Console.Error.WriteLine($"Cannot set configuration property '{property.Name}' of type '{property.PropertyType}' with value '{option.Value}'");
+				}
+			}
+		}
+
+		private static void OverrideReplacement(OptionOverride option)
+		{
+			List<Replacement> newReplacements = [];
+
+			bool addedToList = false;
+			foreach (var r in Configuration.Instance.ReplacementCharacters.Replacements)
+			{
+				if (GetReplacementName(r).EqualsInsensitive(option.Property))
+				{
+					var newReplacement = new Replacement(r.CharacterToReplace, option.Value ?? string.Empty, r.Description)
+					{
+						Mandatory = r.Mandatory
+					};
+					newReplacements.Add(newReplacement);
+					addedToList = true;
+				}
+				else
+				{
+					newReplacements.Add(r);
+				}
+			}
+
+			if (!addedToList)
+			{
+				var charToReplace = option.Property!.Substring(ReplacePrefix.Length);
+				if (charToReplace.Length != 1)
+				{
+					Console.Error.WriteLine($"Invalid character to replace: '{charToReplace}'");
+				}
+				else
+				{
+					newReplacements.Add(new(charToReplace[0], option.Value ?? string.Empty, ""));
+				}
+			}
+			Configuration.Instance.ReplacementCharacters = new ReplacementCharacters { Replacements = newReplacements };
+		}
+
+		const string ReplacePrefix = "Replace_";
+		protected static string GetReplacementName(Replacement r)
+			=> !r.Mandatory ? ReplacePrefix + r.CharacterToReplace
+			: r.CharacterToReplace == '\0' ? ReplacePrefix + "OtherInvalid"
+			: r.CharacterToReplace == '/' ? ReplacePrefix + "Slash"
+			: r.CharacterToReplace == '\\' ? ReplacePrefix + "BackSlash"
+			: r.Description == "Open Quote" ? ReplacePrefix + "OpenQuote"
+			: r.Description == "Close Quote" ? ReplacePrefix + "CloseQuote"
+			: r.Description == "Other Quote" ? ReplacePrefix + "OtherQuote"
+			: ReplacePrefix + r.Description.Replace(" ", "");
+
+		public class OptionOverride
+		{
+			public string? Property { get; }
+			public string? Value { get; }
+
+			public OptionOverride(string value)
+			{
+				if (value is null)
+					return;
+				
+				//Special case of Replace_=  settings
+				var start
+					= value.StartsWithInsensitive(ReplacePrefix + "=")
+					? value.IndexOf('=', ReplacePrefix.Length + 1)
+					: value.IndexOf('=');
+
+				if (start < 1)
+					return;
+				Property = value[..start];
+
+				//Don't trim here. Trim before parsing the value if needed, otherwise
+				//preserve for settings which utilize white space (e.g. Replacements)
+				Value = value[(start + 1)..];
+
+				if (Value.StartsWith('"') && Value.EndsWith('"'))
+				{
+					Value = Value[1..];
+				}
+
+				if (Value.EndsWith('"'))
+				{
+					Value = Value[..^1];
+				}
+			}
+		}
 	}
 }
diff --git a/Source/LibationCli/Options/_ProcessableOptionsBase.cs b/Source/LibationCli/Options/_ProcessableOptionsBase.cs
index 6ad35f7e..6450d20e 100644
--- a/Source/LibationCli/Options/_ProcessableOptionsBase.cs
+++ b/Source/LibationCli/Options/_ProcessableOptionsBase.cs
@@ -1,28 +1,34 @@
 using ApplicationServices;
 using CommandLine;
 using DataLayer;
-using Dinah.Core;
 using FileLiberator;
+using LibationFileManager;
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
 
+#nullable enable
 namespace LibationCli
 {
 	public abstract class ProcessableOptionsBase : OptionsBase
 	{
 
 		[Value(0, MetaName = "[asins]", HelpText = "Optional product IDs of books to process.")]
-		public IEnumerable<string> Asins { get; set; }
+		public IEnumerable<string>? Asins { get; set; }
 
-		protected static TProcessable CreateProcessable<TProcessable>(EventHandler<LibraryBook> completedAction = null)
+		protected static TProcessable CreateProcessable<TProcessable>(EventHandler<LibraryBook>? completedAction = null)
 			where TProcessable : Processable, new()
 		{
 			var progressBar = new ConsoleProgressBar(Console.Out);
 			var strProc = new TProcessable();
+			LibraryBook? currentLibraryBook = null;
 
-			strProc.Begin += (o, e) => Console.WriteLine($"{typeof(TProcessable).Name} Begin: {e}");
+			strProc.Begin += (o, e) =>
+			{
+				currentLibraryBook = e;
+				Console.WriteLine($"{typeof(TProcessable).Name} Begin: {e}");
+			};
 
 			strProc.Completed += (o, e) =>
 			{
@@ -46,24 +52,57 @@ namespace LibationCli
 			strProc.StreamingTimeRemaining += (_, e) => progressBar.RemainingTime = e;
 			strProc.StreamingProgressChanged += (_, e) => progressBar.Progress = e.ProgressPercentage;
 
+			if (strProc is AudioDecodable audDec)
+			{
+				audDec.RequestCoverArt += (_,_) =>
+				{
+					if (currentLibraryBook is null)
+						return null;
+
+					var quality
+						= Configuration.Instance.FileDownloadQuality == Configuration.DownloadQuality.High && currentLibraryBook.Book.PictureLarge is not null
+						? new PictureDefinition(currentLibraryBook.Book.PictureLarge, PictureSize.Native)
+						: new PictureDefinition(currentLibraryBook.Book.PictureId, PictureSize._500x500);
+
+					return PictureStorage.GetPictureSynchronously(quality);
+				};
+			}
+
 			return strProc;
 		}
 
-		protected async Task RunAsync(Processable Processable)
+		protected async Task RunAsync(Processable Processable, Action<LibraryBook>? config = null)
 		{
-			var libraryBooks = DbContexts.GetLibrary_Flat_NoTracking();
-
-			if (Asins.Any())
+			if (Asins?.Any() is true)
 			{
-				var asinsLower = Asins.Select(a => a.TrimStart('[').TrimEnd(']').ToLower()).ToArray();
-
-				foreach (var lb in libraryBooks.Where(lb => lb.Book.AudibleProductId.ToLower().In(asinsLower)))
-					await ProcessOneAsync(Processable, lb, true);
+				foreach (var asin in Asins.Select(a => a.TrimStart('[').TrimEnd(']')))
+				{
+					LibraryBook? lb = null;
+					using (var dbContext = DbContexts.GetContext())
+					{
+						lb = dbContext.GetLibraryBook_Flat_NoTracking(asin, caseSensative: false);
+					}
+					if (lb is not null)
+					{
+						config?.Invoke(lb);
+						await ProcessOneAsync(Processable, lb, true);
+					}
+					else
+					{
+						var msg = $"Book with ASIN '{asin}' not found in library. Skipping.";
+						Console.Error.WriteLine(msg);
+						Serilog.Log.Logger.Error(msg);
+					}
+				}
 			}
 			else
 			{
+				var libraryBooks = DbContexts.GetLibrary_Flat_NoTracking();
 				foreach (var lb in Processable.GetValidLibraryBooks(libraryBooks))
+				{
+					config?.Invoke(lb);
 					await ProcessOneAsync(Processable, lb, false);
+				}
 			}
 
 			var done = "Done. All books have been processed";
@@ -71,7 +110,7 @@ namespace LibationCli
 			Serilog.Log.Logger.Information(done);
 		}
 
-		private static async Task ProcessOneAsync(Processable Processable, LibraryBook libraryBook, bool validate)
+		protected async Task ProcessOneAsync(Processable Processable, LibraryBook libraryBook, bool validate)
 		{
 			try
 			{
diff --git a/Source/LibationCli/Program.cs b/Source/LibationCli/Program.cs
index a6880c7d..efc4636e 100644
--- a/Source/LibationCli/Program.cs
+++ b/Source/LibationCli/Program.cs
@@ -19,7 +19,7 @@ namespace LibationCli
 		public readonly static Type[] VerbTypes = Setup.LoadVerbs();
 		static async Task Main(string[] args)
 		{
-
+			Console.OutputEncoding = Console.InputEncoding = System.Text.Encoding.UTF8;
 #if DEBUG
 			string input = "";
 
@@ -32,6 +32,9 @@ namespace LibationCli
 			//input = "  scan  rmcrackan";
 			//input = "  help  set-status";
 			//input = "  liberate ";
+			//input = "get-setting -o Replace_OpenQuote=[ ";
+			//input = "get-setting ";
+			//input = "liberate B017V4NOZ0 --force -o Books=\"./Books\"";
 
 			// note: this hack will fail for quoted file paths with spaces because it will break on those spaces
 			if (!string.IsNullOrWhiteSpace(input))
@@ -56,15 +59,6 @@ namespace LibationCli
 			else
 			{
 				//Everything parsed correctly, so execute the command
-
-				//***********************************************//
-				//                                               //
-				//   do not use Configuration before this line   //
-				//                                               //
-				//***********************************************//
-				Setup.Initialize();
-
-				// if successfully parsed
 				// async: run parsed options
 				await result.WithParsedAsync<OptionsBase>(opt => opt.Run());
 			}
@@ -108,6 +102,7 @@ namespace LibationCli
 
 		private static void ConfigureParser(ParserSettings settings)
 		{
+			settings.AllowMultiInstance = true;
 			settings.AutoVersion = false;
 			settings.AutoHelp = false;
 		}
diff --git a/Source/LibationCli/Setup.cs b/Source/LibationCli/Setup.cs
index 985bea37..59ff5afe 100644
--- a/Source/LibationCli/Setup.cs
+++ b/Source/LibationCli/Setup.cs
@@ -1,6 +1,8 @@
 using AppScaffolding;
 using CommandLine;
+using LibationFileManager;
 using System;
+using System.IO;
 using System.Linq;
 using System.Reflection;
 
@@ -17,7 +19,19 @@ namespace LibationCli
 			//***********************************************//
 			var config = LibationScaffolding.RunPreConfigMigrations();
 
-			LibationScaffolding.RunPostConfigMigrations(config);
+			if (!Directory.Exists(config.LibationFiles.Location))
+			{
+				Console.Error.WriteLine($"Cannot find LibationFiles at {config.LibationFiles.Location}");
+				PrintLibationFilestipAndExit();
+			}
+
+			if (!File.Exists(config.LibationFiles.SettingsFilePath))
+			{
+				Console.Error.WriteLine($"Cannot find settings files at {config.LibationFiles.SettingsFilePath}");
+				PrintLibationFilestipAndExit();
+			}
+
+			LibationScaffolding.RunPostConfigMigrations(config, ephemeralSettings: true);
 
 #if classic
 			LibationScaffolding.RunPostMigrationScaffolding(Variety.Classic, config);
@@ -26,6 +40,12 @@ namespace LibationCli
 #endif
 		}
 
+		static void PrintLibationFilestipAndExit()
+		{
+			Console.Error.WriteLine($"Override LibationFiles directory location with '--libationFiles' option or '{LibationFiles.LIBATION_FILES_DIR}' environment variable.");
+			Environment.Exit(-1);
+		}
+
 		public static Type[] LoadVerbs() => Assembly.GetExecutingAssembly()
 			.GetTypes()
 			.Where(t => t.GetCustomAttribute<VerbAttribute>() is not null)
diff --git a/Source/LibationCli/TextTableExtention.cs b/Source/LibationCli/TextTableExtention.cs
new file mode 100644
index 00000000..ff86db8f
--- /dev/null
+++ b/Source/LibationCli/TextTableExtention.cs
@@ -0,0 +1,277 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Linq.Expressions;
+
+#nullable enable
+namespace LibationCli;
+
+public enum Justify
+{
+	Left,
+	Right,
+	Center
+}
+
+public class TextTableOptions
+{
+	public Justify Justify { get; set; }
+	public Justify CenterTiebreak { get; set; }
+	public char PaddingCharacter { get; set; } = ' ';
+	public int SideBorderPadding { get; set; } = 1;
+	public int IntercellPadding { get; set; } = 1;
+	public bool DrawBorder { get; set; } = true;
+	public bool DrawHeader { get; set; } = true;
+	public BorderDefinition Border { get; set; } = BorderDefinition.LightRounded;
+}
+
+public record BorderDefinition
+{
+	public char Vertical { get; set; }
+	public char Horizontal { get; set; }
+	public char VerticalSeparator { get; set; }
+	public char HorizontalSeparator { get; set; }
+	public char CornerTopLeft { get; set; }
+	public char CornerTopRight { get; set; }
+	public char CornerBottomLeft { get; set; }
+	public char CornerBottomRight { get; set; }
+	public char Tee { get; set; }
+	public char TeeTop { get; set; }
+	public char TeeBottom { get; set; }
+	public char TeeLeft { get; set; }
+	public char TeeRight { get; set; }
+
+	public BorderDefinition(
+		char vertical,
+		char horizontal,
+		char verticalSeparator,
+		char horizontalSeparator,
+		char cornerTopLef,
+		char cornerTopRight,
+		char cornerBottomLeft,
+		char cornerBottomRight,
+		char tee,
+		char teeTop,
+		char teeBottom,
+		char teeLeft,
+		char teeRight)
+	{
+		Vertical = vertical;
+		Horizontal = horizontal;
+		VerticalSeparator = verticalSeparator;
+		HorizontalSeparator = horizontalSeparator;
+		CornerTopLeft = cornerTopLef;
+		CornerTopRight = cornerTopRight;
+		CornerBottomLeft = cornerBottomLeft;
+		CornerBottomRight = cornerBottomRight;
+		Tee = tee;
+		TeeTop = teeTop;
+		TeeBottom = teeBottom;
+		TeeLeft = teeLeft;
+		TeeRight = teeRight;
+	}
+
+	public void TestPrint(TextWriter writer)
+		=> writer.DrawTable<TestObject>([], new TextTableOptions { Border = this }, t => t.ColA, t => t.ColB, t => t.ColC);
+
+	public static BorderDefinition Ascii => new BorderDefinition('|', '-', '|', '-', '-', '-', '-', '-', '|', '-', '-', '|', '|');
+	public static BorderDefinition Light => new BorderDefinition('│', '─', '│', '─', '┌', '┐', '└', '┘', '┼', '┬', '┴', '├', '┤');
+	public static BorderDefinition Heavy => new BorderDefinition('┃', '━', '┃', '━', '┏', '┓', '┗', '┛', '╋', '┳', '┻', '┣', '┫');
+	public static BorderDefinition Double => new BorderDefinition('║', '═', '║', '═', '╔', '╗', '╚', '╝', '╬', '╦', '╩', '╠', '╣');
+	public static BorderDefinition LightRounded => Light with { CornerTopLeft = '╭', CornerTopRight = '╮', CornerBottomLeft = '╰', CornerBottomRight = '╯' };
+	public static BorderDefinition DoubleHorizontal => Light with { HorizontalSeparator = '═', Tee = '╪', TeeLeft = '╞', TeeRight = '╡' };
+	public static BorderDefinition DoubleVertical => Light with { VerticalSeparator = '║', Tee = '╫', TeeTop = '╥', TeeBottom = '╨' };
+	public static BorderDefinition DoubleOuter => Double with { VerticalSeparator = '│', HorizontalSeparator = '─', TeeLeft = '╟', TeeRight = '╢', Tee = '┼', TeeTop = '╤', TeeBottom = '╧' };
+	public static BorderDefinition DoubleInner => Light with { VerticalSeparator = '║', HorizontalSeparator = '═', TeeLeft = '╞', TeeRight = '╡', Tee = '╬', TeeTop = '╥', TeeBottom = '╨' };
+
+	private record TestObject(string ColA, string ColB, string ColC);
+}
+
+public record ColumnDef<T>(string ColumnName, Func<T, string?> ValueGetter);
+
+public static class TextTableExtention
+{
+	/// <summary>
+	/// Draw a text-based table to the provided TextWriter.
+	/// </summary>
+	/// <typeparam name="T">Data row type</typeparam>
+	/// <param name="textWriter"></param>
+	/// <param name="rows">Data rows to be drawn</param>
+	/// <param name="options">Table drawing options</param>
+	/// <param name="columnSelectors">Data cell selector. Header name is based on member name</param>
+	public static void DrawTable<T>(this TextWriter textWriter, IEnumerable<T> rows, TextTableOptions options, params Expression<Func<T, string>>[] columnSelectors)
+	{
+		//Convert MemberExpression to ColumnDef<T>
+		var columnDefs = new ColumnDef<T>[columnSelectors.Length];
+		for (int i = 0; i < columnDefs.Length; i++)
+		{
+			var exp = columnSelectors[i].Body as MemberExpression
+				   ?? throw new ArgumentException($"Expression at index {i} is not a member access expression", nameof(columnSelectors));
+
+			columnDefs[i] = new ColumnDef<T>(exp.Member.Name, columnSelectors[i].Compile());
+		}
+
+		textWriter.DrawTable(rows, options, columnDefs);
+	}
+
+	/// <summary>
+	/// Draw a text-based table to the provided TextWriter.
+	/// </summary>
+	/// <typeparam name="T">Data row type</typeparam>
+	/// <param name="textWriter"></param>
+	/// <param name="rows">Data rows to be drawn</param>
+	/// <param name="options">Table drawing options</param>
+	/// <param name="columnSelectors">Column header name and cell value selector.</param>
+	public static void DrawTable<T>(this TextWriter textWriter, IEnumerable<T> rows, TextTableOptions options, params ColumnDef<T>[] columnSelectors)
+	{
+		var rowsArray = rows.ToArray();
+		var colNames = columnSelectors.Select(c => c.ColumnName).ToArray();
+
+		var colWidths = new int[columnSelectors.Length];
+		for (int i = 0; i < columnSelectors.Length; i++)
+		{
+			var nameWidth = options.DrawHeader ? StrLen(colNames[i]) : 0;
+			var maxValueWidth = rowsArray.Length == 0 ? 0 : rows.Max(o => StrLen(columnSelectors[i].ValueGetter(o)));
+			colWidths[i] = Math.Max(nameWidth, maxValueWidth);
+		}
+
+		textWriter.DrawTop(colWidths, options);
+		textWriter.DrawHeader(colNames, colWidths, options);
+		foreach (var row in rowsArray)
+		{
+			textWriter.DrawLeft(options, options.Border.Vertical, options.PaddingCharacter);
+
+			var cellValues = columnSelectors.Select((def, j) => def.ValueGetter(row).PadText(colWidths[j], options));
+			textWriter.DrawRow(options, options.Border.VerticalSeparator, options.PaddingCharacter, cellValues);
+
+			textWriter.DrawRight(options, options.Border.Vertical, options.PaddingCharacter);
+		}
+		textWriter.DrawBottom(colWidths, options);
+	}
+
+	private static void DrawHeader(this TextWriter textWriter, string[] colNames, int[] colWidths, TextTableOptions options)
+	{
+		if (!options.DrawHeader)
+			return;
+		//Draw column header names
+		textWriter.DrawLeft(options, options.Border.Vertical, options.PaddingCharacter);
+
+		var cellValues = colNames.Select((n, i) => n.PadText(colWidths[i], options));
+		textWriter.DrawRow(options, options.Border.VerticalSeparator, options.PaddingCharacter, cellValues);
+
+		textWriter.DrawRight(options, options.Border.Vertical, options.PaddingCharacter);
+
+		//Draw header separator
+		textWriter.DrawLeft(options, options.Border.TeeLeft, options.Border.HorizontalSeparator);
+
+		cellValues = colWidths.Select(w => new string(options.Border.HorizontalSeparator, w));
+		textWriter.DrawRow(options, options.Border.Tee, options.Border.HorizontalSeparator, cellValues);
+
+		textWriter.DrawRight(options, options.Border.TeeRight, options.Border.HorizontalSeparator);
+	}
+
+	private static void DrawTop(this TextWriter textWriter, int[] colWidths, TextTableOptions options)
+	{
+		if (!options.DrawBorder)
+			return;
+		textWriter.DrawLeft(options, options.Border.CornerTopLeft, options.Border.Horizontal);
+
+		var cellValues = colWidths.Select(w => new string(options.Border.Horizontal, w));
+		textWriter.DrawRow(options, options.Border.TeeTop, options.Border.Horizontal, cellValues);
+
+		textWriter.DrawRight(options, options.Border.CornerTopRight, options.Border.Horizontal);
+	}
+
+	private static void DrawBottom(this TextWriter textWriter, int[] colWidths, TextTableOptions options)
+	{
+		if (!options.DrawBorder)
+			return;
+		textWriter.DrawLeft(options, options.Border.CornerBottomLeft, options.Border.Horizontal);
+
+		var cellValues = colWidths.Select(w => new string(options.Border.Horizontal, w));
+		textWriter.DrawRow(options, options.Border.TeeBottom, options.Border.Horizontal, cellValues);
+
+		textWriter.DrawRight(options, options.Border.CornerBottomRight, options.Border.Horizontal);
+	}
+
+	private static void DrawLeft(this TextWriter textWriter, TextTableOptions options, char borderChar, char cellPadChar)
+	{
+		if (!options.DrawBorder)
+			return;
+		textWriter.Write(borderChar);
+		textWriter.Write(new string(cellPadChar, options.SideBorderPadding));
+	}
+
+	private static void DrawRight(this TextWriter textWriter, TextTableOptions options, char borderChar, char cellPadChar)
+	{
+		if (options.DrawBorder)
+		{
+			textWriter.Write(new string(cellPadChar, options.SideBorderPadding));
+			textWriter.WriteLine(borderChar);
+		}
+		else
+		{
+			textWriter.WriteLine();
+		}
+	}
+
+	private static void DrawRow(this TextWriter textWriter, TextTableOptions options, char colSeparator, char cellPadChar, IEnumerable<string> cellValues)
+	{
+		var cellPadding = new string(cellPadChar, options.IntercellPadding);
+		var separator = cellPadding + colSeparator + cellPadding;
+		textWriter.Write(string.Join(separator, cellValues));
+	}
+
+	private static string PadText(this string? text, int totalWidth, TextTableOptions options)
+	{
+		if (string.IsNullOrEmpty(text))
+			return new string(options.PaddingCharacter, totalWidth);
+		else if (StrLen(text) >= totalWidth)
+			return text;
+
+		return options.Justify switch
+		{
+			Justify.Right => PadLeft(text),
+			Justify.Center => PadCenter(text),
+			_ or Justify.Left => PadRight(text),
+		};
+
+		string PadCenter(string text)
+		{
+			var half = (totalWidth - StrLen(text)) / 2;
+
+			text = options.CenterTiebreak == Justify.Right
+				? new string(options.PaddingCharacter, half) + text
+				: text + new string(options.PaddingCharacter, half);
+
+			return options.CenterTiebreak == Justify.Right
+				? text.PadRight(totalWidth, options.PaddingCharacter)
+				: text.PadLeft(totalWidth, options.PaddingCharacter);
+		}
+
+		string PadLeft(string text)
+		{
+			var padSize = totalWidth - StrLen(text);
+			return new string(options.PaddingCharacter, padSize) + text;
+		}
+
+		string PadRight(string text)
+		{
+			var padSize = totalWidth - StrLen(text);
+			return text + new string(options.PaddingCharacter, padSize);
+		}
+	}
+
+	/// <summary>
+	/// Determine the width of the string in console characters, accounting for wide unicode characters.
+	/// </summary>
+	private static int StrLen(string? str)
+		=> string.IsNullOrEmpty(str) ? 0 : str.Sum(c => CharIsWide(c) ? 2 : 1);
+
+	/// <summary>
+	/// Determines if the character is a unicode "Full Width" character which takes up two spaces in the console.
+	/// </summary>
+	static bool CharIsWide(char c)
+		=> (c >= '\uFF01' && c <= '\uFF61') || (c >= '\uFFE0' && c <= '\uFFE6');
+}
diff --git a/Source/LibationFileManager/Configuration.Logging.cs b/Source/LibationFileManager/Configuration.Logging.cs
index 999d6e83..ab9593e9 100644
--- a/Source/LibationFileManager/Configuration.Logging.cs
+++ b/Source/LibationFileManager/Configuration.Logging.cs
@@ -15,7 +15,7 @@ namespace LibationFileManager
     {
         private IConfigurationRoot? configuration;
 
-        public bool LoggingEnabled { get; private set; }
+        public bool SerilogInitialized { get; private set; }
 
         public void ConfigureLogging()
         {
@@ -42,7 +42,7 @@ namespace LibationFileManager
 				 .Destructure.ByTransforming<LongPath>(lp => lp.Path)
 				 .Destructure.With<LogFileFilter>()
                  .CreateLogger();
-            LoggingEnabled = true;
+            SerilogInitialized = true;
         }
 
 		[Description("The importance of a log event")]
diff --git a/Source/LibationFileManager/Configuration.PersistentSettings.cs b/Source/LibationFileManager/Configuration.PersistentSettings.cs
index a3d2d98b..39f38391 100644
--- a/Source/LibationFileManager/Configuration.PersistentSettings.cs
+++ b/Source/LibationFileManager/Configuration.PersistentSettings.cs
@@ -7,6 +7,7 @@ using System.Runtime.CompilerServices;
 using FileManager;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
+using Newtonsoft.Json.Linq;
 
 #nullable enable
 namespace LibationFileManager
@@ -18,12 +19,15 @@ namespace LibationFileManager
 		// default setting and directory creation occur in class responsible for files.
 		// config class is only responsible for path. not responsible for setting defaults, dir validation, or dir creation
 		// exceptions: appsettings.json, LibationFiles dir, Settings.json
-		private IPersistentDictionary? persistentDictionary;
-		private IPersistentDictionary Settings => persistentDictionary
+		private IJsonBackedDictionary? JsonBackedDictionary { get; set; }
+		private IJsonBackedDictionary Settings => JsonBackedDictionary
 			?? throw new InvalidOperationException($"{nameof(LoadPersistentSettings)} must first be called prior to accessing {nameof(Settings)}");
 
 		internal void LoadPersistentSettings(string settingsFile)
-			=> persistentDictionary = new PersistentDictionary(settingsFile);
+			=> JsonBackedDictionary = new PersistentDictionary(settingsFile);
+
+		internal void LoadEphemeralSettings(JObject dataStore)
+			=> JsonBackedDictionary = new EphemeralDictionary(dataStore);
 
 		private LibationFiles? _libationFiles;
 		[Description("Location for storage of program-created files")]
diff --git a/Source/LibationFileManager/Configuration.cs b/Source/LibationFileManager/Configuration.cs
index bae0f0a3..e0f879b8 100644
--- a/Source/LibationFileManager/Configuration.cs
+++ b/Source/LibationFileManager/Configuration.cs
@@ -21,7 +21,7 @@ namespace LibationFileManager
 				throw new InvalidOperationException($"Can only mock {nameof(Configuration)} in Debug mode or in test assemblies.");
 #endif
 
-			var mockInstance = new Configuration() { persistentDictionary = new MockPersistentDictionary() };
+			var mockInstance = new Configuration() { JsonBackedDictionary = new EphemeralDictionary() };
 			mockInstance.SetString("Light", "ThemeVariant");
 			Instance = mockInstance;
 			return mockInstance;
diff --git a/Source/LibationFileManager/MockPersistentDictionary.cs b/Source/LibationFileManager/EphemeralDictionary.cs
similarity index 80%
rename from Source/LibationFileManager/MockPersistentDictionary.cs
rename to Source/LibationFileManager/EphemeralDictionary.cs
index 60bf245f..8e7fbb69 100644
--- a/Source/LibationFileManager/MockPersistentDictionary.cs
+++ b/Source/LibationFileManager/EphemeralDictionary.cs
@@ -4,16 +4,25 @@ using Newtonsoft.Json.Linq;
 #nullable enable
 namespace LibationFileManager;
 
-internal class MockPersistentDictionary : IPersistentDictionary
+internal class EphemeralDictionary : IJsonBackedDictionary
 {
-	private JObject JsonObject { get; } = new();
+	private JObject JsonObject { get; }
+
+	public EphemeralDictionary()
+	{
+		JsonObject = new();
+	}
+	public EphemeralDictionary(JObject dataStore)
+	{
+		JsonObject = dataStore;
+	}
 
 	public bool Exists(string propertyName)
 		=> JsonObject.ContainsKey(propertyName);
 	public string? GetString(string propertyName, string? defaultValue = null)
 		=> JsonObject[propertyName]?.Value<string>() ?? defaultValue;
 	public T? GetNonString<T>(string propertyName, T? defaultValue = default)
-		=> GetObject(propertyName) is object obj ? IPersistentDictionary.UpCast<T>(obj) : defaultValue;
+		=> GetObject(propertyName) is object obj ? IJsonBackedDictionary.UpCast<T>(obj) : defaultValue;
 	public object? GetObject(string propertyName)
 		=> JsonObject[propertyName]?.Value<object>();
 	public void SetString(string propertyName, string? newValue)
diff --git a/Source/LibationFileManager/LibationFiles.cs b/Source/LibationFileManager/LibationFiles.cs
index 28d4bad0..7e1a249e 100644
--- a/Source/LibationFileManager/LibationFiles.cs
+++ b/Source/LibationFileManager/LibationFiles.cs
@@ -25,6 +25,7 @@ public  class LibationFiles
 
 	public const string LIBATION_FILES_KEY = "LibationFiles";
 	public const string SETTINGS_JSON = "Settings.json";
+	public const string LIBATION_FILES_DIR = "LIBATION_FILES_DIR";
 
 	/// <summary>
 	/// Directory pointed to by appsettings.json
@@ -38,13 +39,25 @@ public  class LibationFiles
 	/// <summary>
 	/// Found Location of appsettings.json. This file must exist or be able to be created for Libation to start.
 	/// </summary>
-	internal string AppsettingsJsonFile { get; }
+	internal string? AppsettingsJsonFile { get; }
 	/// <summary>
 	/// File path to Settings.json inside <see cref="Location"/>
 	/// </summary>
 	public string SettingsFilePath => Path.Combine(Location, SETTINGS_JSON);
 
-	internal LibationFiles() : this(GetOrCreateAppsettingsFile()) { }
+	internal LibationFiles()
+	{
+		var libationFilesDir = Environment.GetEnvironmentVariable(LIBATION_FILES_DIR);
+		if (Directory.Exists(libationFilesDir))
+		{
+			Location = libationFilesDir;
+		}
+		else
+		{
+			AppsettingsJsonFile = GetOrCreateAppsettingsFile();
+			Location = GetLibationFilesFromAppsettings(AppsettingsJsonFile);
+		}
+	}
 
 	internal LibationFiles(string appSettingsFile)
 	{
@@ -57,6 +70,12 @@ public  class LibationFiles
 	/// </summary>
 	public void SetLibationFiles(LongPath libationFilesDirectory)
 	{
+		if (AppsettingsJsonFile is null)
+		{
+			Environment.SetEnvironmentVariable(LIBATION_FILES_DIR, libationFilesDirectory);
+			return;
+		}
+
 		var startingContents = File.ReadAllText(AppsettingsJsonFile);
 		var jObj = JObject.Parse(startingContents);
 
diff --git a/Source/LibationWinForms/Program.cs b/Source/LibationWinForms/Program.cs
index a3e8abd1..8c123f33 100644
--- a/Source/LibationWinForms/Program.cs
+++ b/Source/LibationWinForms/Program.cs
@@ -1,13 +1,11 @@
 using ApplicationServices;
 using AppScaffolding;
 using DataLayer;
-using Dinah.Core.WindowsDesktop.Processes;
 using LibationFileManager;
 using LibationUiBase;
 using LibationWinForms.Dialogs;
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 using System.Windows.Forms;
@@ -90,7 +88,7 @@ namespace LibationWinForms
 			// global exception handling (ShowAdminAlert) attempts to use logging. only call it after logging has been init'd
 			postLoggingGlobalExceptionHandling();
 
-			var form1 = new Form1();
+			form1 = new Form1();
 			form1.Load += async (_, _) => await form1.InitLibraryAsync(await libraryLoadTask);
 			Application.Run(form1);
 		}

From c0898a288b85b471199de603f6e5905bc047ba69 Mon Sep 17 00:00:00 2001
From: MBucari <mbucari1@gmail.com>
Date: Thu, 20 Nov 2025 09:55:35 -0700
Subject: [PATCH 17/18] Additional LibationCli documentation

Move CLI examples to the bottom of the page.
---
 Documentation/Advanced.md | 155 ++++++++++++++++++++++++--------------
 1 file changed, 99 insertions(+), 56 deletions(-)

diff --git a/Documentation/Advanced.md b/Documentation/Advanced.md
index 4c438c08..b4463f2b 100644
--- a/Documentation/Advanced.md
+++ b/Documentation/Advanced.md
@@ -10,12 +10,10 @@
 - [Files and folders](#files-and-folders)
 - [Settings](#settings)
 - [Custom File Naming](NamingTemplates.md)
-- [Command Line Interface](#command-line-interface)
 - [Custom Theme Colors](#custom-theme-colors) (Chardonnay Only)
+- [Command Line Interface](#command-line-interface)
 - [Audio Formats (Dolby Atmos, Widevine, Spacial Audio)](AudioFileFormats.md)
 
-
-
 ### Files and folders
 
 To make upgrades and reinstalls easier, Libation separates all of its responsibilities to a few different folders. If you don't want to mess with this stuff: ignore it. Read on if you like a little more control over your files.
@@ -39,59 +37,6 @@ In addition to the options that are enabled if you allow Libation to "fix up" th
 * Replaces the chapter markers embedded in the aax file with the chapter markers retrieved from Audible's API.
 * Sets the embedded cover art image with the 500x500 px cover art retrieved from Audible
 
-### Command Line Interface
-
-Libationcli.exe allows limited access to Libation's functionalities as a CLI.
-
-Warnings about relying solely on on the CLI:
-* CLI will not perform any upgrades.
-* It will show that there is an upgrade, but that will likely scroll by too fast to notice.
-* It will not perform all post-upgrade migrations. Some migrations are only be possible by launching GUI.
-
-```
-help
-  libationcli --help
-  
-verb-specific help
-  libationcli scan --help
-  
-scan all libraries
-  libationcli scan
-scan only libraries for specific accounts
-  libationcli scan nickname1 nickname2
-  
-convert all m4b files to mp3
-  libationcli convert
-  
-liberate all books and pdfs
-  libationcli liberate
-liberate pdfs only
-  libationcli liberate --pdf
-  libationcli liberate -p
-
-Copy the local sqlite database to postgres
-  libationcli copydb --connectionString "my postgres connection string"
-  libationcli copydb -c "my postgres connection string"
-  
-export library to file
-  libationcli export --path "C:\foo\bar\my.json" --json
-  libationcli export -p "C:\foo\bar\my.json" -j
-  libationcli export -p "C:\foo\bar\my.csv" --csv
-  libationcli export -p "C:\foo\bar\my.csv" -c
-  libationcli export -p "C:\foo\bar\my.xlsx" --xlsx
-  libationcli export -p "C:\foo\bar\my.xlsx" -x
-
-Set download statuses throughout library based on whether each book's audio file can be found.   
-Must include at least one flag: --downloaded , --not-downloaded.  
-Downloaded: If the audio file can be found, set download status to 'Downloaded'.  
-Not Downloaded: If the audio file cannot be found, set download status to 'Not Downloaded'  
-UI: Visible Books \> Set 'Downloaded' status automatically. Visible books. Prompts before saving changes  
-CLI: Full library. No prompt
-
-  libationcli set-status -d
-  libationcli set-status -n
-  libationcli set-status -d -n
-```
 ### Custom Theme Colors
 
 In Libation Chardonnay (not Classic), you may adjust the app colors using the built-in theme editor. Open the Settings window (from the menu bar: Settings > Settings). On the "Important" settings tab, click "Edit Theme Colors".
@@ -113,4 +58,102 @@ The below video demonstrates using the theme editor to make changes to the Dark
 
 [](https://github.com/user-attachments/assets/05c0cb7f-578f-4465-9691-77d694111349)
 
+### Command Line Interface
 
+Libationcli.exe allows limited access to Libation's functionalities as a CLI.
+
+Warnings about relying solely on on the CLI:
+* CLI will not perform any upgrades.
+* It will show that there is an upgrade, but that will likely scroll by too fast to notice.
+* It will not perform all post-upgrade migrations. Some migrations are only be possible by launching GUI.
+
+#### Help
+```console
+libationcli --help
+```
+#### Verb-Specific Help
+```console
+libationcli scan --help
+```
+#### Scan All Libraries
+```console
+libationcli scan
+```
+#### Scan Only Libraries for Specific Accounts
+```console
+libationcli scan nickname1 nickname2
+```
+#### Convert All m4b Files to mp3
+```console
+libationcli convert
+```
+#### Liberate All Books and Pdfs
+```console
+libationcli liberate
+```
+#### Liberate Pdfs Only
+```console
+libationcli liberate --pdf
+libationcli liberate -p
+```
+#### Force Book(s) to Re-Liberate
+```console
+libationcli liberate --force
+libationcli liberate -f
+```
+#### List Libation Settings
+```console
+libationcli get-setting
+libationcli get-setting -b
+libationcli get-setting FileDownloadQuality
+```
+#### Override Libation Settings for the Command
+```console
+libationcli liberate B017V4IM1G -override FileDownloadQuality=Normal
+libationcli liberate B017V4IM1G -o FileDownloadQuality=normal -o UseWidevine=true Request_xHE_AAC=true -f
+```
+#### Copy the Local SQLite Database to Postgres
+```console
+libationcli copydb --connectionString "my postgres connection string"
+libationcli copydb -c "my postgres connection string"
+```
+#### Export Library to File
+```console
+libationcli export --path "C:\foo\bar\my.json" --json
+libationcli export -p "C:\foo\bar\my.json" -j
+libationcli export -p "C:\foo\bar\my.csv" --csv
+libationcli export -p "C:\foo\bar\my.csv" -c
+libationcli export -p "C:\foo\bar\my.xlsx" --xlsx
+libationcli export -p "C:\foo\bar\my.xlsx" -x
+```
+#### Set Download Status
+Set download statuses throughout library based on whether each book's audio file can be found.   
+Must include at least one flag: --downloaded , --not-downloaded.  
+Downloaded: If the audio file can be found, set download status to 'Downloaded'.  
+Not Downloaded: If the audio file cannot be found, set download status to 'Not Downloaded'  
+UI: Visible Books \> Set 'Downloaded' status automatically. Visible books. Prompts before saving changes  
+CLI: Full library. No prompt
+
+```console
+libationcli set-status -d
+libationcli set-status -n
+libationcli set-status -d -n
+```
+#### Get a Content License Without Downloading
+```console
+libationcli get-license B017V4IM1G
+```
+#### Example Powershell Script to Download Four Differenf Versions f the Same Book
+```powershell
+$asin="B017V4IM1G"
+
+$xHE_AAC=@('true', 'false')
+$Qualities=@('Normal', 'High')
+foreach($q in $Qualities){
+  foreach($x in $xHE_AAC){
+	$license = ./libationcli get-license $asin --override FileDownloadQuality=$q --override Request_xHE_AAC=$x
+	echo $($license | ConvertFrom-Json).ContentMetadata.content_reference
+	echo $license | ./libationcli liberate --force
+  }
+}
+```

From 7fe170acdf55df96bfc48d6f7d462efdc9ab95ac Mon Sep 17 00:00:00 2001
From: MBucari <mbucari1@gmail.com>
Date: Thu, 20 Nov 2025 10:42:14 -0700
Subject: [PATCH 18/18] Fix CLI help tex being squashed to a single column

---
 Source/LibationCli/Options/_OptionsBase.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Source/LibationCli/Options/_OptionsBase.cs b/Source/LibationCli/Options/_OptionsBase.cs
index 5aecac9f..636cb036 100644
--- a/Source/LibationCli/Options/_OptionsBase.cs
+++ b/Source/LibationCli/Options/_OptionsBase.cs
@@ -19,7 +19,7 @@ namespace LibationCli
 		[Option(longName: "libationFiles", HelpText = "Path to Libation Files directory")]
 		public DirectoryInfo? LibationFiles { get; set; }
 
-		[Option('o', "override",  HelpText = "Configuration setting override", MetaValue = "[SettingName]=\"Setting_Value\"")]
+		[Option('o', "override",  HelpText = "Configuration setting override [SettingName]=\"Setting_Value\"")]
 		public IEnumerable<OptionOverride>? SettingOverrides { get; set; }
 
 		public async Task Run()