Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
C# audioaudio-unitavaloniacpp20cross-platformdawdigital-audio-workstationdspjucelinux-audiomcp-servermidimusicmusic-productionpiano-rollplugin-hostsequencersynthesizervstvst3
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 Egor Khindikaynen (Nota). See LICENSES/ for license terms.
//
// Welcome screen plumbing: build the launcher, feed it the recent-projects list, and
// wire its actions back to the main window. Recent projects are recorded here on every
// successful open/save (see MainWindow.Files.OpenProject / DoSaveAsync); File → Open recent
// shows the same list (MainWindow.RecentMenu).
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using Avalonia.Input;
using Avalonia.Interactivity;
using Microsoft.Extensions.DependencyInjection;
using Nota.Application;
using Nota.Presentation;
namespace Nota.App;
public partial class MainWindow
{
private const int MaxRecentProjects = 10;
/// <summary>Show the welcome launcher over the (empty) main window; completes when it closes.</summary>
private async Task ShowWelcomeAsync()
{
var settings = App.Services.GetRequiredService<ISettingsService>();
var recent = LoadRecentItems(settings);
// Fold the crash-recovery prompt into the launcher as an inline banner. When there's
// no surviving snapshot the arguments stay null and no banner is drawn.
string? recoveryMessage = PendingRecovery is { } info ? RecoveryPromptText(info) : null;
WelcomeWindow? win = null;
win = new WelcomeWindow(
recent,
onNew: () => OnMenuNew(this, EventArgs.Empty),
onOpen: () => _ = DoOpenAsync(),
onOpenRecent: OpenProject,
onSettings: () => new PreferencesWindow(new SettingsViewModel(settings), _vm).ShowDialog(win!),
onWhatsNew: () => new WhatsNewWindow(AppInfo.UnseenSince("")).ShowDialog(win!),
showOnStartup: settings.Current.ShowWelcomeOnStartup,
onShowOnStartupChanged: v => { settings.Current.ShowWelcomeOnStartup = v; settings.Save(); },
recoveryMessage: recoveryMessage,
onRecover: recoveryMessage is null ? null
: () => { if (PendingRecovery is { } ri) ApplyPendingRecovery(ri); win!.Close(); },
onDismissRecovery: () => { try { _recovery.ClearRecovery(); } catch { } });
// Whatever choice closes the launcher (New / Open / recent), the crash snapshot has
// been offered — resolve it exactly once so it isn't re-offered next launch.
if (PendingRecovery is not null)
win.Closed += (_, _) => { try { _recovery.ClearRecovery(); } catch { } };
// A newer release (AppUpdates: checked on launch, and by Help → Check for updates…)
// shows as a banner, now or when the check comes back while the launcher is open.
// "Restart now" quits through the normal close path (the installer runs on exit — see
// App's Exit hook) and relaunches the new version.
win.ShowUpdates(AppUpdates.Shared, restart: () => { win.Close(); Close(); });
// Shown owned rather than modal, so a click on the main window behind it can close it
// like the close button does (#67) — not while the launcher has its own dialog open
// (Settings, What's New), which that click is meant to come back to.
var closed = new TaskCompletionSource();
void OutsidePress(object? s, PointerPressedEventArgs e)
{
if (win.OwnedWindows.Count > 0) return;
win.Close();
e.Handled = true; // the click only dismisses; it doesn't also act on the main window
}
AddHandler(PointerPressedEvent, OutsidePress, RoutingStrategies.Tunnel);
win.Closed += (_, _) => { RemoveHandler(PointerPressedEvent, OutsidePress); closed.TrySetResult(); };
win.Show(this);
await closed.Task;
}
// Turn the persisted path list into displayable rows, dropping folders that no longer
// exist (moved/deleted since last run). Newest first — the stored order is maintained.
private static IReadOnlyList<RecentProjectItem> LoadRecentItems(ISettingsService settings)
{
var items = new List<RecentProjectItem>();
foreach (var path in settings.Current.RecentProjects)
{
if (string.IsNullOrWhiteSpace(path) || !Directory.Exists(path)) continue;
var name = Path.GetFileNameWithoutExtension(path.TrimEnd('/', '\\'));
string modified;
// The same date the browser's Projects tab shows (spec 092): the last save.
modified = Nota.Application.Browser.ProjectDates.Modified(path) is { } m ? Nota.Application.Browser.ProjectDates.Format(m) : "";
items.Add(new RecentProjectItem(name, path, modified));
}
return items;
}
/// <summary>Move a project bundle to the top of the recent list and persist. Called on
/// every successful open/save so the welcome screen always reflects real usage.</summary>
private void RecordRecentProject(string dir)
{
try
{
var settings = App.Services.GetRequiredService<ISettingsService>();
var list = settings.Current.RecentProjects;
list.RemoveAll(p => string.Equals(p, dir, StringComparison.OrdinalIgnoreCase));
list.Insert(0, dir);
if (list.Count > MaxRecentProjects) list.RemoveRange(MaxRecentProjects, list.Count - MaxRecentProjects);
settings.Save();
RefreshRecentMenu(); // File → Open recent follows the same list
if (_vm is not null)
{
_vm.Browser.OpenProjectPath = dir; // the Projects tab marks it, newest first
_vm.Browser.RebuildProjects();
}
}
catch { /* recent list is best-effort — never disrupt the open/save */ }
}
}