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 — the launcher shown on startup (see MainWindow.ShowWelcomeAsync), as
// drawn in nota-design/Nota Start.html. Brand header, New / Open actions, a list of
// recent projects (click selects, double-click / Return opens, ↑ ↓ move), and shortcuts to
// Settings and What's New, plus banners for crash recovery and a newer release on
// GitHub (which downloads and installs it in place — see AppUpdates). New / Open / a recent project close the launcher and hand
// off to the main window; Settings and What's New open as child dialogs so the user
// stays on the launcher.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using Avalonia;
using Avalonia.Controls;
using Avalonia.Layout;
using Avalonia.Media;
using Avalonia.Animation;
using Avalonia.Animation.Easings;
using Avalonia.Data;
using Avalonia.Input;
using Avalonia.Threading;
using Microsoft.Extensions.DependencyInjection;
using Nota.Application;
using Nota.Application.Localization;
namespace Nota.App;
/// <summary>One row on the welcome screen's recent-projects list.</summary>
public sealed record RecentProjectItem(string Name, string Path, string Modified);
public sealed class WelcomeWindow : NotaWindow
{
public WelcomeWindow(
IReadOnlyList<RecentProjectItem> recent,
Action onNew,
Action onOpen,
Action<string> onOpenRecent,
Action onSettings,
Action onWhatsNew,
bool showOnStartup,
Action<bool> onShowOnStartupChanged,
string? recoveryMessage = null,
Action? onRecover = null,
Action? onDismissRecovery = null)
{
Title = Loc.T("welcome.welcome_to_nota");
Width = 640;
Height = 560; // including the title-bar band
CanResize = false;
WindowStartupLocation = WindowStartupLocation.CenterScreen;
Background = NotaPalette.Panel;
BlendTitleBar();
_recent = recent;
_onOpenRecent = onOpenRecent;
var root = new Grid
{
Margin = new Thickness(28, 12, 28, 20),
RowDefinitions = new RowDefinitions("Auto,Auto,*,Auto"),
};
// --- Brand header --------------------------------------------------
var header = new StackPanel { Orientation = Orientation.Horizontal, Spacing = 16 };
header.Children.Add(new BrandMark { VerticalAlignment = VerticalAlignment.Center });
var brand = new StackPanel { Spacing = 6, VerticalAlignment = VerticalAlignment.Center };
brand.Children.Add(new TextBlock
{
Text = Loc.T("common.nota"),
FontSize = NotaType.Title,
FontWeight = FontWeight.SemiBold,
LetterSpacing = -0.4,
LineHeight = NotaType.Title,
Foreground = NotaPalette.TextHeading,
});
brand.Children.Add(new TextBlock
{
Text = Loc.F("welcome.version_engine_desktop_daw", AppInfo.Version, App.Services.GetRequiredService<EngineBuildInfo>().Version),
FontFamily = NotaFonts.ValuesFamily,
FontSize = NotaType.Value,
Foreground = NotaPalette.TextMuted,
});
header.Children.Add(brand);
Grid.SetRow(header, 0);
root.Children.Add(header);
// --- Primary actions ----------------------------------------------
var actions = new StackPanel
{
Orientation = Orientation.Horizontal,
Spacing = 8,
Margin = new Thickness(0, 20, 0, 20),
};
var newBtn = new Button { Content = Loc.T("common.new_project"), Classes = { "primary" }, FontWeight = FontWeight.SemiBold };
newBtn.Click += (_, _) => { Close(); onNew(); };
var openBtn = new Button { Content = Loc.T("welcome.open_project") };
openBtn.Click += (_, _) => { Close(); onOpen(); };
actions.Children.Add(newBtn);
actions.Children.Add(openBtn);
Grid.SetRow(actions, 1);
root.Children.Add(actions);
// --- Recent projects ----------------------------------------------
var recentHead = new StackPanel { Orientation = Orientation.Horizontal, Spacing = 8, Margin = new Thickness(0, 0, 0, 8) };
recentHead.Children.Add(new TextBlock { Classes = { "SectionLabel" }, Text = Loc.T("welcome.recent_projects"), VerticalAlignment = VerticalAlignment.Bottom });
recentHead.Children.Add(new TextBlock
{
Text = recent.Count.ToString(NotaNum.Culture),
FontFamily = NotaFonts.ValuesFamily,
FontSize = NotaType.Eyebrow,
Foreground = NotaPalette.TextDisabled,
VerticalAlignment = VerticalAlignment.Bottom,
Margin = new Thickness(0, 0, 0, 1),
});
Control wellBody;
if (recent.Count == 0)
{
wellBody = new TextBlock
{
Text = Loc.T("welcome.no_recent_projects"),
FontSize = NotaType.Body,
Foreground = NotaPalette.TextTertiary,
HorizontalAlignment = HorizontalAlignment.Center,
VerticalAlignment = VerticalAlignment.Center,
};
}
else
{
var list = new StackPanel();
for (int i = 0; i < recent.Count; i++)
{
var row = new RecentRow(recent[i]);
int index = i;
row.PointerPressed += (_, e) =>
{
if (!e.GetCurrentPoint(row).Properties.IsLeftButtonPressed) return;
Select(index);
if (e.ClickCount == 2) OpenRecent(index);
e.Handled = true;
};
_rows.Add(row);
list.Children.Add(row);
}
wellBody = _scroll = new ScrollViewer
{
Content = list,
HorizontalScrollBarVisibility = Avalonia.Controls.Primitives.ScrollBarVisibility.Disabled,
};
Select(0);
}
var well = new Border
{
Background = NotaPalette.BgSunken,
BorderBrush = NotaPalette.GraphBorder,
BorderThickness = new Thickness(1),
CornerRadius = NotaRadius.Group,
Padding = new Thickness(4),
ClipToBounds = true,
Child = wellBody,
};
well[!Border.BoxShadowProperty] = well.GetResourceObservable("Shadow.Sunken").ToBinding();
var recentPanel = new DockPanel();
DockPanel.SetDock(recentHead, Dock.Top);
recentPanel.Children.Add(recentHead);
recentPanel.Children.Add(well);
Grid.SetRow(recentPanel, 2);
root.Children.Add(recentPanel);
// --- Footer: show-on-startup + Documentation / Settings / What's New --------------
var footer = new Grid
{
Margin = new Thickness(0, 20, 0, 0),
ColumnDefinitions = new ColumnDefinitions("Auto,*,Auto,Auto,Auto"),
};
var startupTrack = new SwitchTrack { IsOn = showOnStartup };
var startup = new Border
{
Background = Brushes.Transparent,
Cursor = new Cursor(StandardCursorType.Hand),
VerticalAlignment = VerticalAlignment.Center,
Child = new StackPanel
{
Orientation = Orientation.Horizontal,
Spacing = 8,
Children =
{
startupTrack,
new TextBlock
{
Text = Loc.T("welcome.show_on_startup"),
FontSize = NotaType.Body,
Foreground = NotaPalette.TextStrong,
VerticalAlignment = VerticalAlignment.Center,
},
},
},
};
startup.PointerPressed += (_, e) =>
{
if (!e.GetCurrentPoint(startup).Properties.IsLeftButtonPressed) return;
startupTrack.IsOn = !startupTrack.IsOn;
onShowOnStartupChanged(startupTrack.IsOn);
e.Handled = true;
};
Grid.SetColumn(startup, 0);
footer.Children.Add(startup);
// The user manual, for a first launch that wants a guided start.
var docsBtn = FooterLink(Loc.T("common.documentation"));
docsBtn.Click += (_, _) => NotaDocs.Open(this, "start-here/first-track");
Grid.SetColumn(docsBtn, 2);
footer.Children.Add(docsBtn);
var settingsBtn = FooterLink(Loc.T("common.settings"));
settingsBtn.Margin = new Thickness(8, 0, 0, 0);
settingsBtn.Click += (_, _) => onSettings();
Grid.SetColumn(settingsBtn, 3);
footer.Children.Add(settingsBtn);
var whatsNewBtn = FooterLink(Loc.T("welcome.whats_new"));
whatsNewBtn.Margin = new Thickness(8, 0, 0, 0);
whatsNewBtn.Click += (_, _) => onWhatsNew();
Grid.SetColumn(whatsNewBtn, 4);
footer.Children.Add(whatsNewBtn);
Grid.SetRow(footer, 3);
root.Children.Add(footer);
// Banners (crash recovery, available update) stack above the content. The update
// banner arrives asynchronously — see ShowUpdateAvailable.
_banners = new StackPanel();
var outer = new DockPanel();
DockPanel.SetDock(_banners, Dock.Top);
outer.Children.Add(_banners);
outer.Children.Add(root);
// Crash-recovery prompt (same wording as the standalone recovery dialog). Absent
// when there's no surviving snapshot.
if (recoveryMessage is not null && onRecover is not null)
{
Border banner = null!;
banner = RecoveryBanner(
recoveryMessage,
onRecover,
onDismiss: () =>
{
onDismissRecovery?.Invoke();
_banners.Children.Remove(banner);
});
_banners.Children.Add(banner);
}
SetBody(outer);
}
private readonly IReadOnlyList<RecentProjectItem> _recent;
private readonly Action<string> _onOpenRecent;
private readonly List<RecentRow> _rows = new();
private ScrollViewer? _scroll;
private int _selected = -1;
private bool _opening;
// ↑ / ↓ move the selection through the recent list, Return opens it. Esc closes the
// launcher like its close button: the current project stays (#67).
protected override void OnKeyDown(KeyEventArgs e)
{
if (e.Key == Key.Escape && !_opening) { Close(); e.Handled = true; }
else if (_rows.Count > 0 && !_opening)
{
switch (e.Key)
{
case Key.Down: Select(Math.Min(_rows.Count - 1, _selected + 1)); e.Handled = true; break;
case Key.Up: Select(Math.Max(0, _selected - 1)); e.Handled = true; break;
case Key.Enter: OpenRecent(_selected); e.Handled = true; break;
}
}
if (!e.Handled) base.OnKeyDown(e);
}
private void Select(int index)
{
if (index < 0 || index >= _rows.Count) return;
if (_selected >= 0) _rows[_selected].IsSelected = false;
_selected = index;
_rows[index].IsSelected = true;
_rows[index].BringIntoView();
}
// Mark the row "Opening…", let that frame land, then close the launcher and hand the
// project to the main window (loading blocks the UI thread).
private void OpenRecent(int index)
{
if (_opening || index < 0 || index >= _rows.Count) return;
_opening = true;
_rows[index].ShowOpening();
var path = _recent[index].Path;
Dispatcher.UIThread.Post(() => { Close(); _onOpenRecent(path); }, DispatcherPriority.Background);
}
// A quiet text button in the footer: Ink 3, a hover wash, no face.
private static Button FooterLink(string text) => new()
{
Content = text,
Classes = { "ghost" },
Padding = new Thickness(10, 0),
Foreground = NotaPalette.TextSecondary,
};
private readonly StackPanel _banners;
/// <summary>Show the "new version available" banner whenever the app's update state
/// (AppUpdates) has a release the user hasn't waved off — now, or when the launch check
/// finds one while the launcher is still open. When this install can update itself it
/// downloads in place (progress in the banner), then offers Restart now / Later — Later
/// installs on quit. Otherwise Download opens the release page.</summary>
internal void ShowUpdates(AppUpdates updates, Action restart)
{
var banner = new UpdateBanner(updates, restart, _banners);
Closed += (_, _) => banner.Detach();
}
// The update banner follows the shared state: offer → downloading → ready (or failed →
// try again). Dismiss / Later wave the release off everywhere (the status bar too).
private sealed class UpdateBanner
{
private readonly AppUpdates _updates;
private readonly Action _restart;
private readonly StackPanel _host;
private readonly Border _card;
private AppUpdates.Stage _shown = (AppUpdates.Stage)(-1);
private ProgressBar? _bar;
private TextBlock? _message;
public UpdateBanner(AppUpdates updates, Action restart, StackPanel host)
{
_updates = updates;
_restart = restart;
_host = host;
_card = BannerCard();
updates.Changed += Render;
updates.ProgressChanged += ShowProgress;
Render();
}
public void Detach()
{
_updates.Changed -= Render;
_updates.ProgressChanged -= ShowProgress;
}
private void Render()
{
var u = _updates;
bool show = u.Release is not null && u.State != AppUpdates.Stage.None && !u.Dismissed;
if (!show)
{
_host.Children.Remove(_card);
_shown = (AppUpdates.Stage)(-1);
return;
}
if (!_host.Children.Contains(_card)) _host.Children.Add(_card);
if (u.State == _shown) return;
_shown = u.State;
var release = u.Release!;
var top = TopLevel.GetTopLevel(_host);
_bar = null;
_message = null;
_card.Child = u.State switch
{
AppUpdates.Stage.Downloading => Downloading(release),
AppUpdates.Stage.Ready => BannerContent(Loc.F("welcome.nota_is_ready_to_install", release.Version),
Loc.T("welcome.restart_nota_to_finish_updating"),
progress: null,
(Loc.T("welcome.restart_now"), true, () => u.Restart(_restart)),
(Loc.T("welcome.later"), false, u.Dismiss)),
AppUpdates.Stage.Failed => BannerContent(Loc.T("welcome.the_update_didnt_download"), u.Error ?? "",
progress: null,
(Loc.T("common.try_again"), true, () => u.Download(top)),
(Loc.T("welcome.dismiss"), false, u.Dismiss)),
_ when u.CanInstall => BannerContent(Loc.T("welcome.a_new_version_of_nota"),
Loc.F("welcome.nota_is_out_you_have", release.Version, AppInfo.Version),
progress: null,
(Loc.T("common.update"), true, () => u.Download(top)),
(Loc.T("welcome.release_notes"), false, () => u.OpenReleasePage(top)),
(Loc.T("welcome.dismiss"), false, u.Dismiss)),
_ => BannerContent(Loc.T("welcome.a_new_version_of_nota"),
Loc.F("welcome.nota_is_out_you_have", release.Version, AppInfo.Version),
progress: null,
(Loc.T("common.download"), true, () => u.Download(top)),
(Loc.T("welcome.dismiss"), false, u.Dismiss)),
};
}
private Grid Downloading(AppRelease release)
{
_bar = new ProgressBar
{
Minimum = 0, Maximum = 1, Height = 4, Margin = new Thickness(0, 6, 0, 0),
Foreground = NotaPalette.Accent, Background = NotaPalette.BorderDefault,
};
var content = BannerContent(Loc.F("common.downloading_nota", release.Version), "", _bar,
(Loc.T("common.cancel"), false, _updates.CancelDownload));
_message = (TextBlock)((StackPanel)content.Children[0]).Children[1]; // BannerContent's message line
ShowProgress();
return content;
}
private void ShowProgress()
{
if (_bar is null || _message is null || _updates.Release?.Asset is not { } asset) return;
var p = _updates.Progress;
if (p.Fraction < 0)
{
_bar.IsIndeterminate = true;
_message.Text = p.Message;
return;
}
var size = asset.Size / 1048576.0;
_bar.Value = p.Fraction;
_message.Text = $"{(p.Fraction * size).ToString("0.0", NotaNum.Culture)} / {NotaNum.Unit(size, "0.0", "MB")}"
+ $" · {NotaNum.Unit(p.Fraction * 100, "0", "%")}";
}
}
// Offer to restore a crashed session.
private static Border RecoveryBanner(string message, Action onRecover, Action onDismiss)
=> Banner(Loc.T("welcome.unsaved_work_available"), message, Loc.T("welcome.recover"), onRecover, onDismiss);
// A dismissible alert card with one action. Accent-tinted so it reads as an action
// prompt, not an error.
private static Border Banner(string title, string message, string actionLabel,
Action onAction, Action onDismiss)
{
var card = BannerCard();
card.Child = BannerContent(title, message, progress: null,
(actionLabel, true, onAction), (Loc.T("welcome.dismiss"), false, onDismiss));
return card;
}
private static Border BannerCard() => new()
{
Background = NotaPalette.SurfaceRaised,
BorderBrush = NotaPalette.Seam,
BorderThickness = new Thickness(1),
CornerRadius = NotaRadius.Group,
Padding = new Thickness(14, 12),
Margin = new Thickness(28, 16, 28, 0),
};
// Title + message (+ an optional progress bar) on the left, buttons on the right. The
// first "main" button is a plain button (not the primary: "New project" is this window's
// primary action); the rest are ghosts.
private static Grid BannerContent(string title, string message, Control? progress,
params (string Label, bool Main, Action OnClick)[] actions)
{
var text = new StackPanel { Spacing = 2, VerticalAlignment = VerticalAlignment.Center };
text.Children.Add(new TextBlock
{
Text = title,
FontSize = 12,
FontWeight = FontWeight.SemiBold,
Foreground = NotaPalette.TextPrimary,
});
text.Children.Add(new TextBlock
{
Text = message,
FontSize = 11,
Foreground = NotaPalette.TextSecondary,
TextWrapping = TextWrapping.Wrap,
});
if (progress is not null) text.Children.Add(progress);
var grid = new Grid { ColumnDefinitions = new ColumnDefinitions("*" + string.Concat(Enumerable.Repeat(",Auto", actions.Length))) };
grid.Children.Add(text);
for (int i = 0; i < actions.Length; i++)
{
var (label, main, onClick) = actions[i];
var button = new Button
{
Content = label,
VerticalAlignment = VerticalAlignment.Center,
Margin = new Thickness(i == 0 ? 12 : 6, 0, 0, 0),
};
if (!main) button.Classes.Add("ghost");
button.Click += (_, _) => onClick();
Grid.SetColumn(button, i + 1);
grid.Children.Add(button);
}
return grid;
}
// One line of the recent list: name left, modified date right in mono. The selected
// row takes the brass wash and a 2px brass edge; hover washes the others.
private sealed class RecentRow : Border
{
private readonly Border _edge;
private readonly TextBlock _name, _meta;
private bool _selected, _hover;
public RecentRow(RecentProjectItem item)
{
Height = 28;
CornerRadius = NotaRadius.Cell;
Padding = new Thickness(12, 0, 10, 0);
Transitions = new Transitions
{
new BrushTransition { Property = BackgroundProperty, Duration = TimeSpan.FromMilliseconds(120), Easing = new CubicEaseOut() },
};
ToolTip.SetTip(this, item.Path);
_edge = new Border
{
Width = 2,
Margin = new Thickness(-12, 7, 0, 7),
CornerRadius = NotaRadius.Fine,
HorizontalAlignment = HorizontalAlignment.Left,
};
_name = new TextBlock
{
Text = item.Name,
FontSize = NotaType.Name,
FontWeight = FontWeight.Medium,
TextTrimming = TextTrimming.CharacterEllipsis,
VerticalAlignment = VerticalAlignment.Center,
};
_meta = new TextBlock
{
Text = item.Modified,
FontFamily = NotaFonts.ValuesFamily,
FontSize = NotaType.Value,
VerticalAlignment = VerticalAlignment.Center,
Margin = new Thickness(12, 0, 0, 0),
};
var grid = new Grid { ColumnDefinitions = new ColumnDefinitions("*,Auto") };
Grid.SetColumn(_meta, 1);
grid.Children.Add(_name);
grid.Children.Add(_meta);
var layer = new Panel();
layer.Children.Add(grid);
layer.Children.Add(_edge);
Child = layer;
PointerEntered += (_, _) => { _hover = true; Paint(); };
PointerExited += (_, _) => { _hover = false; Paint(); };
Paint();
}
public bool IsSelected { get => _selected; set { _selected = value; Paint(); } }
public void ShowOpening()
{
_meta.Text = Loc.T("welcome.opening");
_meta.Foreground = NotaPalette.AccentHover;
}
private void Paint()
{
Background = _selected ? NotaPalette.SurfaceHover : _hover ? NotaPalette.SurfaceRaised : NotaPalette.Wash(NotaPalette.SurfaceRaised, 0);
_edge.Background = _selected ? NotaPalette.Accent : null;
_name.Foreground = _selected ? NotaPalette.TextPrimary : NotaPalette.TextStrong;
_meta.Foreground = _selected ? NotaPalette.TextSecondary : NotaPalette.TextMuted;
}
}
}