Published NUGET Package

Author: DevMando

src/MandoCode/Components/Banner.razor

@@ -9,7 +9,9 @@
             PlayMatrixGlitch();
         }
 
-        var gradientText = BuildGradientBanner();
+        var version = typeof(Program).Assembly.GetName().Version;
+        var versionStr = version != null ? $"v{version.Major}.{version.Minor}.{version.Build}" : "";
+        var gradientText = BuildGradientBanner(versionStr);
 
         // Animation: (eyeColor, wavePhase)
         // wavePhase 0 = no howl waves, 1-3 = expanding waves
@@ -165,7 +167,7 @@
         );
     }
 
-    private static string BuildGradientBanner()
+    private static string BuildGradientBanner(string version)
     {
         int maxWidth = _figletLines.Max(l => l.Length);
         var sb = new System.Text.StringBuilder();
@@ -201,6 +203,15 @@
                 sb.Append('\n');
         }
 
+        // Version tag right-aligned under the figlet
+        if (!string.IsNullOrEmpty(version))
+        {
+            var pad = Math.Max(0, maxWidth - version.Length);
+            sb.Append('\n');
+            sb.Append(new string(' ', pad));
+            sb.Append($"[rgb(140,100,200)]{version}[/]");
+        }
+
         return sb.ToString();
     }
 

src/MandoCode/MC.ico

@@ -5,6 +5,23 @@
     <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
+
+    <!-- dotnet tool settings -->
+    <PackAsTool>true</PackAsTool>
+    <ToolCommandName>mandocode</ToolCommandName>
+    <PackageId>MandoCode</PackageId>
+
+    <!-- NuGet metadata -->
+    <Version>0.9.0</Version>
+    <Authors>Armando Fernandez (DevMando)</Authors>
+    <Description>Your AI coding assistant — run locally or in the cloud with Ollama. No API keys required. Just you and your code.</Description>
+    <PackageProjectUrl>https://github.com/DevMando/MandoCode</PackageProjectUrl>
+    <RepositoryUrl>https://github.com/DevMando/MandoCode</RepositoryUrl>
+    <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageTags>ai;cli;coding-assistant;ollama;semantic-kernel;local-llm</PackageTags>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <PackageIcon>MC.png</PackageIcon>
+    <ApplicationIcon>MC.ico</ApplicationIcon>
   </PropertyGroup>
 
   <ItemGroup>
@@ -18,7 +35,12 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Content Include="Audio\**\*.mp3" CopyToOutputDirectory="PreserveNewest" />
+    <EmbeddedResource Include="Audio\**\*.mp3" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include="..\..\README.md" Pack="true" PackagePath="\" />
+    <None Include="MC.png" Pack="true" PackagePath="\" />
   </ItemGroup>
 
 </Project>

src/MandoCode/MC.png

@@ -23,8 +23,8 @@ public static void Display()
                 new Markup("Large language models with [bold]publicly available weights[/] that run on your own machine."),
                 new Markup("Unlike cloud AI (ChatGPT, Claude), they are [green]free[/], [green]private[/], and [green]offline[/]."),
                 new Markup(""),
-                new Markup("Open-weight models give you full control — no API keys, no usage limits,"),
-                new Markup("no data leaving your computer. Your code stays on your machine.")
+                new Markup("Open-weight models give you full control — no API keys, no usage limits."),
+                new Markup("Run locally or use Ollama cloud. Your code, your choice.")
             ))
         {
             Border = BoxBorder.Rounded,

src/MandoCode/MandoCode.csproj

@@ -25,6 +25,7 @@ public record MusicTrackInfo
     public string Name { get; init; } = "";
     public string Genre { get; init; } = "";
     public string FileName { get; init; } = "";
+    public string ResourceName { get; init; } = "";
     public string FilePath { get; init; } = "";
     public TimeSpan Duration { get; init; }
 }

src/MandoCode/Models/LearnContent.cs

@@ -10,13 +10,16 @@ namespace MandoCode.Services;
 public class MusicPlayerService : IDisposable
 {
     private readonly MandoCodeConfig _config;
-    private readonly string _audioBasePath;
+    private readonly System.Reflection.Assembly _assembly;
+    private readonly string _userMusicPath;
     private readonly Random _random = new();
     private readonly object _lock = new();
 
     private WaveOutEvent? _waveOut;
     private LoopStream? _loopStream;
-    private AudioFileReader? _audioFileReader;
+    private MemoryStream? _resourceStream;
+    private Mp3FileReader? _mp3Reader;
+    private WaveChannel32? _volumeChannel;
     private List<MusicTrackInfo> _tracks = new();
     private bool _disposed;
 
@@ -28,41 +31,82 @@ public class MusicPlayerService : IDisposable
     public bool AudioAvailable { get; private set; } = true;
     public string? AudioError { get; private set; }
 
+    public string UserMusicPath => _userMusicPath;
+
     public MusicPlayerService(MandoCodeConfig config)
     {
         _config = config;
+        _assembly = typeof(MusicPlayerService).Assembly;
+        _userMusicPath = Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
+            ".mandocode", "music");
 
-        // Resolve audio path relative to the application binary
-        var appDir = AppContext.BaseDirectory;
-        _audioBasePath = Path.Combine(appDir, "Audio");
-
+        EnsureUserMusicFolders();
         DiscoverTracks();
     }
 
     /// <summary>
-    /// Discovers all MP3 files in Audio/lofi/ and Audio/synthwave/ directories.
+    /// Creates ~/.mandocode/music/lofi/ and ~/.mandocode/music/synthwave/ if they don't exist.
+    /// </summary>
+    private void EnsureUserMusicFolders()
+    {
+        try
+        {
+            Directory.CreateDirectory(Path.Combine(_userMusicPath, "lofi"));
+            Directory.CreateDirectory(Path.Combine(_userMusicPath, "synthwave"));
+        }
+        catch { /* non-critical */ }
+    }
+
+    /// <summary>
+    /// Discovers MP3 tracks from embedded resources and the user's ~/.mandocode/music/ folder.
+    /// Embedded resource names follow: {RootNamespace}.Audio.{genre}.{filename}.mp3
+    /// User tracks follow: ~/.mandocode/music/{genre}/{filename}.mp3
     /// </summary>
     private void DiscoverTracks()
     {
         _tracks.Clear();
 
-        if (!Directory.Exists(_audioBasePath))
-            return;
-
-        foreach (var genreDir in Directory.GetDirectories(_audioBasePath))
+        // 1. Embedded resources (bundled defaults)
+        var prefix = "MandoCode.Audio.";
+        foreach (var resourceName in _assembly.GetManifestResourceNames())
         {
-            var genre = Path.GetFileName(genreDir).ToLowerInvariant();
-            var mp3Files = Directory.GetFiles(genreDir, "*.mp3", SearchOption.TopDirectoryOnly);
+            if (!resourceName.StartsWith(prefix) || !resourceName.EndsWith(".mp3"))
+                continue;
+
+            var afterPrefix = resourceName[prefix.Length..];
+            var firstDot = afterPrefix.IndexOf('.');
+            if (firstDot < 0) continue;
 
-            foreach (var mp3 in mp3Files)
+            var genre = afterPrefix[..firstDot];
+            var trackFile = afterPrefix[(firstDot + 1)..];
+            var trackName = Path.GetFileNameWithoutExtension(trackFile).Replace('_', ' ');
+
+            _tracks.Add(new MusicTrackInfo
+            {
+                Name = trackName,
+                Genre = genre,
+                FileName = trackFile,
+                ResourceName = resourceName
+            });
+        }
+
+        // 2. User's custom tracks from ~/.mandocode/music/{genre}/*.mp3
+        if (Directory.Exists(_userMusicPath))
+        {
+            foreach (var genreDir in Directory.GetDirectories(_userMusicPath))
             {
-                _tracks.Add(new MusicTrackInfo
+                var genre = Path.GetFileName(genreDir).ToLowerInvariant();
+                foreach (var mp3 in Directory.GetFiles(genreDir, "*.mp3", SearchOption.TopDirectoryOnly))
                 {
-                    Name = Path.GetFileNameWithoutExtension(mp3),
-                    Genre = genre,
-                    FileName = Path.GetFileName(mp3),
-                    FilePath = mp3
-                });
+                    _tracks.Add(new MusicTrackInfo
+                    {
+                        Name = Path.GetFileNameWithoutExtension(mp3),
+                        Genre = genre,
+                        FileName = Path.GetFileName(mp3),
+                        FilePath = mp3
+                    });
+                }
             }
         }
     }
@@ -105,7 +149,7 @@ public bool Play(string? genre = null)
             genreTracks = _tracks.ToList();
             if (genreTracks.Count == 0)
             {
-                AudioError = "No MP3 files found. Add .mp3 files to Audio/lofi/ or Audio/synthwave/ directories.";
+                AudioError = $"No MP3 files found. Drop .mp3 files into ~/.mandocode/music/{{genre}}/ (e.g. {_userMusicPath}/lofi/)";
                 return false;
             }
         }
@@ -114,7 +158,7 @@ public bool Play(string? genre = null)
         MusicTrackInfo track;
         if (genreTracks.Count > 1 && CurrentTrack != null)
         {
-            var candidates = genreTracks.Where(t => t.FilePath != CurrentTrack.FilePath).ToList();
+            var candidates = genreTracks.Where(t => t != CurrentTrack).ToList();
             track = candidates[_random.Next(candidates.Count)];
         }
         else
@@ -126,7 +170,7 @@ public bool Play(string? genre = null)
     }
 
     /// <summary>
-    /// Plays a specific track with looped playback.
+    /// Plays a specific track with looped playback. Supports both embedded resources and local files.
     /// </summary>
     private bool PlayTrack(MusicTrackInfo track)
     {
@@ -137,9 +181,33 @@ private bool PlayTrack(MusicTrackInfo track)
 
             try
             {
-                _audioFileReader = new AudioFileReader(track.FilePath);
-                _audioFileReader.Volume = _config.Music.Volume;
-                _loopStream = new LoopStream(_audioFileReader);
+                if (!string.IsNullOrEmpty(track.FilePath))
+                {
+                    // Local file track
+                    _mp3Reader = new Mp3FileReader(track.FilePath);
+                }
+                else
+                {
+                    // Embedded resource track
+                    var stream = _assembly.GetManifestResourceStream(track.ResourceName);
+                    if (stream == null)
+                    {
+                        AudioError = $"Embedded audio resource not found: {track.ResourceName}";
+                        return false;
+                    }
+
+                    // Copy to MemoryStream for seeking support (required for looping)
+                    _resourceStream = new MemoryStream();
+                    stream.CopyTo(_resourceStream);
+                    _resourceStream.Position = 0;
+                    stream.Dispose();
+
+                    _mp3Reader = new Mp3FileReader(_resourceStream);
+                }
+
+                _volumeChannel = new WaveChannel32(_mp3Reader);
+                _volumeChannel.Volume = _config.Music.Volume;
+                _loopStream = new LoopStream(_volumeChannel);
 
                 _waveOut = new WaveOutEvent();
                 _waveOut.Init(_loopStream);
@@ -189,14 +257,18 @@ private void StopInternal()
             _waveOut?.Stop();
             _waveOut?.Dispose();
             _loopStream?.Dispose();
-            _audioFileReader?.Dispose();
+            _volumeChannel?.Dispose();
+            _mp3Reader?.Dispose();
+            _resourceStream?.Dispose();
         }
         catch { /* Swallow disposal errors */ }
         finally
         {
             _waveOut = null;
             _loopStream = null;
-            _audioFileReader = null;
+            _volumeChannel = null;
+            _mp3Reader = null;
+            _resourceStream = null;
         }
     }
 
@@ -242,9 +314,9 @@ public void SetVolume(float volume)
 
         lock (_lock)
         {
-            if (_audioFileReader != null)
+            if (_volumeChannel != null)
             {
-                _audioFileReader.Volume = volume;
+                _volumeChannel.Volume = volume;
             }
         }
 

src/MandoCode/Models/MusicModels.cs

@@ -91,7 +91,7 @@ public static void RenderTrackList(MusicPlayerService player)
         if (tracks.Count == 0)
         {
             Console.WriteLine($"  {LabelClr}No tracks found.{Rst}");
-            Console.WriteLine($"  {DimClr}Add .mp3 files to Audio/lofi/ or Audio/synthwave/ directories.{Rst}");
+            Console.WriteLine($"  {DimClr}Drop .mp3 files into ~/.mandocode/music/lofi/ or ~/.mandocode/music/synthwave/{Rst}");
             Console.WriteLine();
             return;
         }
@@ -107,7 +107,7 @@ public static void RenderTrackList(MusicPlayerService player)
 
             foreach (var track in group)
             {
-                var playing = player.CurrentTrack?.FilePath == track.FilePath;
+                var playing = player.CurrentTrack == track;
                 var marker = playing ? $"{StateClr}\u25b6" : " ";
                 Console.WriteLine($"  {Border}\u2502 {marker} {TrackClr}\u266b {track.Name}{Rst}");
             }