Keep the files in N1MM's folders

The folders under the user's own directory are N1MM's now, with N1MM's names,
read out of N1MMLibrary.dll: Databases, SupportFiles, UserDefinedContests,
FunctionKeyMessages, CallHistoryFiles, ExportFiles, GoalFiles, LettersFiles,
QsoRecording, SkinsAndLayouts, SystemFiles, TransactionLogFiles, Diagnostics
and Wav. A station that runs both programs keeps its files in one shape.

An operator's recordings go in Wav/<his callsign>, which is where N1MM plays
them from, and the folder is made when he takes the radio. Cabrillo and ADIF
start in ExportFiles, call history files in CallHistoryFiles, and the .mc
function key files in FunctionKeyMessages.

N1MM's three *DDL folders and its Piper folders are left out: they hold the
migrations for N1MM's own admin databases and the program it speaks with.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RoGtneMQaz4M9w7Kk49AVD
This commit is contained in:
2026-08-31 22:59:45 +00:00
parent 654adda080
commit 2c51b5293a
7 changed files with 204 additions and 8 deletions

View File

@@ -2,6 +2,13 @@ namespace Nonemm.App.Configuration;
/// Where the operator's files live. Windows keeps them under Documents the way
/// N1MM does; everywhere else follows the XDG configuration directory.
///
/// The folders inside are N1MM's own, with N1MM's names, so a station that runs
/// both programs keeps its files in the same shape: `Wav/<operator>/Cq.wav` is
/// where N1MM looks for that operator's recordings, and so is this. N1MM's
/// three `*DDL` folders and its `Piper` folders are left out: those hold the
/// migrations for N1MM's own admin databases and the program it speaks with,
/// and neither has anything to do with a log.
public sealed class UserPaths
{
public UserPaths(string root)
@@ -10,6 +17,17 @@ public sealed class UserPaths
Databases = Path.Combine(root, "Databases");
UserDefinedContests = Path.Combine(root, "UserDefinedContests");
SupportFiles = Path.Combine(root, "SupportFiles");
FunctionKeyMessages = Path.Combine(root, "FunctionKeyMessages");
CallHistoryFiles = Path.Combine(root, "CallHistoryFiles");
ExportFiles = Path.Combine(root, "ExportFiles");
GoalFiles = Path.Combine(root, "GoalFiles");
LettersFiles = Path.Combine(root, "LettersFiles");
QsoRecording = Path.Combine(root, "QsoRecording");
SkinsAndLayouts = Path.Combine(root, "SkinsAndLayouts");
SystemFiles = Path.Combine(root, "SystemFiles");
TransactionLogFiles = Path.Combine(root, "TransactionLogFiles");
Diagnostics = Path.Combine(root, "Diagnostics");
Wav = Path.Combine(root, "Wav");
}
public static UserPaths Default() => new(DefaultRoot());
@@ -22,6 +40,38 @@ public sealed class UserPaths
public string SupportFiles { get; }
/// The `.mc` function key files, which N1MM imports and exports here.
public string FunctionKeyMessages { get; }
public string CallHistoryFiles { get; }
/// Cabrillo and ADIF, in and out.
public string ExportFiles { get; }
/// N1MM's rate targets, its letter and number recordings, its recorded
/// contacts, its window layouts, its own settings files, its transaction
/// logs and its traces. Nothing here writes to them yet; they are made so
/// that a station that keeps files in them does not lose them when it moves
/// between the two programs.
public string GoalFiles { get; }
public string LettersFiles { get; }
public string QsoRecording { get; }
public string SkinsAndLayouts { get; }
public string SystemFiles { get; }
public string TransactionLogFiles { get; }
public string Diagnostics { get; }
/// The voice keyer's recordings. Each operator has a folder of his own
/// under it, named for his callsign, which is how N1MM finds the voice of
/// whoever is at the microphone.
public string Wav { get; }
public string SettingsFile => Path.Combine(Root, "settings.json");
public string CountryFile => Path.Combine(SupportFiles, "wl_cty.dat");
@@ -32,14 +82,42 @@ public sealed class UserPaths
/// from so a later version can read more out of it.
public string ClusterListFile => Path.Combine(SupportFiles, "cluster-list.html");
/// One operator's recordings: `Wav/OM3KFF/Cq.wav` and the rest. Without an
/// operator the folder itself is the answer, which is where a station with
/// one operator keeps them.
public string WavFor(string operatorCallsign) =>
operatorCallsign.Trim().Length == 0
? Wav
: Path.Combine(Wav, operatorCallsign.Trim().ToUpperInvariant());
public void CreateFolders()
{
Directory.CreateDirectory(Root);
Directory.CreateDirectory(Databases);
Directory.CreateDirectory(UserDefinedContests);
Directory.CreateDirectory(SupportFiles);
foreach (string folder in All())
{
Directory.CreateDirectory(folder);
}
}
/// Every folder that is made at startup, the root first.
public IReadOnlyList<string> All() =>
[
Root,
Databases,
UserDefinedContests,
SupportFiles,
FunctionKeyMessages,
CallHistoryFiles,
ExportFiles,
GoalFiles,
LettersFiles,
QsoRecording,
SkinsAndLayouts,
SystemFiles,
TransactionLogFiles,
Diagnostics,
Wav,
];
private static string DefaultRoot() =>
OperatingSystem.IsWindows()
? Path.Combine(

View File

@@ -33,9 +33,19 @@ public sealed partial class MessagesDialog : Window
private readonly ModeCategory mode;
public MessagesDialog(ModeCategory mode, string text, string what = "Function key messages")
/// The folder import and export start in: `FunctionKeyMessages`, which is
/// where N1MM keeps its `.mc` files. Null leaves the picker wherever it was
/// last.
private readonly string? folder;
public MessagesDialog(
ModeCategory mode,
string text,
string what = "Function key messages",
string? folder = null)
{
this.mode = mode;
this.folder = folder;
InitializeComponent();
Title = $"{what} — {(mode == ModeCategory.Phone ? "phone" : "CW")}";
TextArea.Text = text.Trim().Length > 0 ? text : Messages.DefaultFor(mode);
@@ -105,6 +115,7 @@ public sealed partial class MessagesDialog : Window
Title = "Import a function key file",
AllowMultiple = false,
FileTypeFilter = [MessageFiles],
SuggestedStartLocation = await Start(),
});
if (files.FirstOrDefault()?.TryGetLocalPath() is not { } path)
{
@@ -126,6 +137,7 @@ public sealed partial class MessagesDialog : Window
{
Title = "Export the function key file",
SuggestedFileName = mode == ModeCategory.Phone ? "phone.mc" : "cw.mc",
SuggestedStartLocation = await Start(),
DefaultExtension = "mc",
FileTypeChoices = [MessageFiles],
});
@@ -149,4 +161,7 @@ public sealed partial class MessagesDialog : Window
private void OnSave(object? sender, RoutedEventArgs e) => Close(TextArea.Text ?? "");
private void OnCancel(object? sender, RoutedEventArgs e) => Close(null);
private async Task<IStorageFolder?> Start() =>
folder is null ? null : await StorageProvider.TryGetFolderFromPathAsync(folder);
}

View File

@@ -52,7 +52,7 @@ public sealed partial class EntryWindow
string stored = mode == ModeCategory.Phone
? session.Settings.PhoneMessageFile
: session.Settings.CwMessageFile;
if (await new MessagesDialog(mode, stored).ShowDialog<string?>(this) is not { } edited)
if (await new MessagesDialog(mode, stored, folder: session.Paths.FunctionKeyMessages).ShowDialog<string?>(this) is not { } edited)
{
return;
}

View File

@@ -102,6 +102,7 @@ public sealed partial class EntryWindow
{
Title = "Export Cabrillo",
SuggestedFileName = $"{session.Settings.Station.Callsign}.log",
SuggestedStartLocation = await Folder(session.Paths.ExportFiles),
});
if (file?.TryGetLocalPath() is not { } path)
{
@@ -142,6 +143,7 @@ public sealed partial class EntryWindow
{
Title = "Export ADIF",
SuggestedFileName = $"{session.Settings.Station.Callsign}.adi",
SuggestedStartLocation = await Folder(session.Paths.ExportFiles),
});
if (file?.TryGetLocalPath() is not { } path)
{
@@ -162,6 +164,7 @@ public sealed partial class EntryWindow
{
Title = "Import ADIF",
AllowMultiple = false,
SuggestedStartLocation = await Folder(session.Paths.ExportFiles),
});
if (files.FirstOrDefault()?.TryGetLocalPath() is not { } path)
{
@@ -573,7 +576,7 @@ public sealed partial class EntryWindow
{
Title = "Call history file",
AllowMultiple = false,
SuggestedStartLocation = await Folder(session.Paths.SupportFiles),
SuggestedStartLocation = await Folder(session.Paths.CallHistoryFiles),
});
if (files.FirstOrDefault()?.TryGetLocalPath() is not { } path)
{

View File

@@ -41,6 +41,7 @@ public sealed partial class EntryWindow
? known with { WavPath = wanted.WavPath }
// a new operator starts with the windows and colours on the screen
: wanted with { Theme = settings.Theme, Windows = Layout() };
stored = stored with { WavPath = WavFolder(stored) };
session.Save(settings with
{
Operators = [.. settings.Operators.Where(o => !Is(o, stored.Callsign)), stored],
@@ -62,6 +63,28 @@ public sealed partial class EntryWindow
Status($"operator {stored.Callsign}");
}
/// The operator's recordings folder: the one he named, or `Wav/<callsign>`
/// beside the rest of the files, which is where N1MM keeps them. The folder
/// is made, so there is somewhere to put the files rather than a path that
/// is not there.
private string WavFolder(StoredOperator stored)
{
string folder = stored.WavPath.Trim().Length > 0
? stored.WavPath.Trim()
: session.Paths.WavFor(stored.Callsign);
try
{
Directory.CreateDirectory(folder);
}
catch (Exception failure) when (failure is IOException or UnauthorizedAccessException)
{
// a folder on a drive that is not there is still worth keeping: it
// is the operator's own setting, and he is the one who fixes it
Status($"{folder} could not be made: {failure.Message}");
}
return folder;
}
/// Puts a window where this operator last had it. Windows are opened one at
/// a time, so each one is placed as it appears rather than all at once.
private void Place(Window window, StoredOperator? stored = null)