From 75bb571b6bc8c86e419cdfbe9797e32033d70bca Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Mon, 21 Jul 2025 01:01:09 -0500
Subject: [PATCH 01/24] feat: wip...got full transcription all in memory
---
src/Directory.packages.props | 9 +-
src/StreamShorts.Console/.editorconfig | 2 +
src/StreamShorts.Console/Program.cs | 96 ++++++++++++++++++-
.../Resources/Resources.resx | 6 ++
.../StreamShorts.Console.csproj | 6 ++
5 files changed, 114 insertions(+), 5 deletions(-)
create mode 100644 src/StreamShorts.Console/.editorconfig
diff --git a/src/Directory.packages.props b/src/Directory.packages.props
index d727d6b..46ac85d 100644
--- a/src/Directory.packages.props
+++ b/src/Directory.packages.props
@@ -1,7 +1,10 @@
-
true
-
-
+
+
+
\ No newline at end of file
diff --git a/src/StreamShorts.Console/.editorconfig b/src/StreamShorts.Console/.editorconfig
new file mode 100644
index 0000000..79a8d3d
--- /dev/null
+++ b/src/StreamShorts.Console/.editorconfig
@@ -0,0 +1,2 @@
+[*.cs]
+dotnet_diagnostic.CA2007.severity = none
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Program.cs b/src/StreamShorts.Console/Program.cs
index 82d8e79..b98e09e 100644
--- a/src/StreamShorts.Console/Program.cs
+++ b/src/StreamShorts.Console/Program.cs
@@ -1,7 +1,99 @@
-// See https://aka.ms/new-console-template for more information
-using System.Globalization;
+using System.Globalization;
using System.Resources;
+using System.Text;
+
+using FFMpegCore;
+using FFMpegCore.Enums;
+using FFMpegCore.Pipes;
+
+using NAudio.Wave;
+
+using Whisper.net;
+using Whisper.net.Ggml;
var resourceManager = new ResourceManager("StreamShorts.Console.Resources.Resources", typeof(Program).Assembly);
Console.WriteLine(resourceManager.GetString("WelcomeMessage", CultureInfo.CurrentCulture));
+
+// Step 1: Retrieve stream
+if (args.Length is 0)
+{
+ Console.WriteLine(resourceManager.GetString("StreamNotProvided", CultureInfo.CurrentCulture));
+ return;
+}
+
+using var mp3Stream = new MemoryStream();
+using var mp4Stream = new FileStream(args[0], FileMode.Open, FileAccess.Read);
+
+var wasExtracted = await FFMpegArguments
+ .FromPipeInput(new StreamPipeSource(mp4Stream))
+ .OutputToPipe(
+ new StreamPipeSink(mp3Stream),
+ o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
+ )
+ .ProcessAsynchronously();
+
+if (wasExtracted is false)
+{
+ Console.WriteLine(resourceManager.GetString("Mp3ExtractionFailed", CultureInfo.CurrentCulture));
+ return;
+}
+
+// Step 2: Convert MP3 stream to 16khz wave format
+mp3Stream.Position = 0;
+using var reader = new Mp3FileReader(mp3Stream);
+var outFormat = new WaveFormat(16000, reader.WaveFormat.Channels);
+using var resampler = new MediaFoundationResampler(reader, outFormat);
+using var waveStream = new MemoryStream();
+WaveFileWriter.WriteWavFileToStream(waveStream, resampler);
+
+// Step 3: Split the wave stream into 2 minute segments
+waveStream.Position = 0;
+var segmentDuration = TimeSpan.FromMinutes(2);
+var segments = new List();
+using var waveReader = new WaveFileReader(waveStream);
+var segmentCount = (int)Math.Ceiling(waveReader.TotalTime.TotalMilliseconds / segmentDuration.TotalMilliseconds);
+
+Directory.CreateDirectory("segments");
+
+foreach (var i in Enumerable.Range(0, segmentCount))
+{
+ waveStream.Position = 0;
+ using var segmentWaveReader = new WaveFileReader(waveStream);
+ var segment = segmentWaveReader.ToSampleProvider()
+ .Skip(i * segmentDuration)
+ .Take(segmentDuration);
+ var segmentProvider = segment.ToWaveProvider16();
+ var segmentStream = new MemoryStream();
+ WaveFileWriter.WriteWavFileToStream(segmentStream, segmentProvider);
+ segmentStream.Position = 0;
+ segments.Add(segmentStream);
+}
+
+// Step 4: Transcribe each segment using Whisper
+using var modelMemoryStream = new MemoryStream();
+var model = await WhisperGgmlDownloader.Default.GetGgmlModelAsync(GgmlType.TinyEn);
+await model.CopyToAsync(modelMemoryStream);
+var whisperFactory = WhisperFactory.FromBuffer(modelMemoryStream.ToArray());
+using var whisperProcessor = whisperFactory.CreateBuilder()
+ .WithLanguage("en")
+ .Build();
+
+foreach (var (i, segment) in segments.Select((s, index) => (index, s)))
+{
+ var durationOffset = TimeSpan.FromMilliseconds(i * segmentDuration.TotalMilliseconds);
+ var segmentTranscription = new StringBuilder();
+
+ await foreach (var result in whisperProcessor.ProcessAsync(segment, CancellationToken.None))
+ {
+ var startTime = result.Start + durationOffset;
+ var endTime = result.End + durationOffset;
+ segmentTranscription.AppendLine(CultureInfo.CurrentCulture, $"[{startTime:hh\\:mm\\:ss} - {endTime:hh\\:mm\\:ss}] {result.Text}");
+ }
+
+ await File.AppendAllTextAsync("transcription.txt", segmentTranscription.ToString());
+}
+
+// Step 5: Send the transcription to LLM for analysis
+
+// Step 6: Use analysis to generate a short video
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Resources/Resources.resx b/src/StreamShorts.Console/Resources/Resources.resx
index 5a85d0b..c866a39 100644
--- a/src/StreamShorts.Console/Resources/Resources.resx
+++ b/src/StreamShorts.Console/Resources/Resources.resx
@@ -3,4 +3,10 @@
Welcome to StreamShorts!
+
+ No stream provided. Please specify a stream to process.
+
+
+ Failed to extract MP3 from the provided stream.
+
\ No newline at end of file
diff --git a/src/StreamShorts.Console/StreamShorts.Console.csproj b/src/StreamShorts.Console/StreamShorts.Console.csproj
index 6a70a1a..38b1fd9 100644
--- a/src/StreamShorts.Console/StreamShorts.Console.csproj
+++ b/src/StreamShorts.Console/StreamShorts.Console.csproj
@@ -4,4 +4,10 @@
Exe
+
+
+
From da5134bad00babb0ad9e7989b17108b2b527f123 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Mon, 21 Jul 2025 23:51:59 -0500
Subject: [PATCH 02/24] =?UTF-8?q?feat:=20it=20works=20=F0=9F=A5=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
src/StreamShorts.Console/Program.cs | 93 ++++++++++++++++++++++++++++-
1 file changed, 90 insertions(+), 3 deletions(-)
diff --git a/src/StreamShorts.Console/Program.cs b/src/StreamShorts.Console/Program.cs
index b98e09e..7dcaacd 100644
--- a/src/StreamShorts.Console/Program.cs
+++ b/src/StreamShorts.Console/Program.cs
@@ -1,6 +1,9 @@
-using System.Globalization;
+using System.Diagnostics;
+using System.Globalization;
using System.Resources;
using System.Text;
+using System.Text.Json;
+using System.Text.Json.Serialization;
using FFMpegCore;
using FFMpegCore.Enums;
@@ -11,6 +14,9 @@ using NAudio.Wave;
using Whisper.net;
using Whisper.net.Ggml;
+
+var stopwatch = new Stopwatch();
+stopwatch.Start();
var resourceManager = new ResourceManager("StreamShorts.Console.Resources.Resources", typeof(Program).Assembly);
Console.WriteLine(resourceManager.GetString("WelcomeMessage", CultureInfo.CurrentCulture));
@@ -79,6 +85,8 @@ using var whisperProcessor = whisperFactory.CreateBuilder()
.WithLanguage("en")
.Build();
+var completeTranscription = new StringBuilder();
+
foreach (var (i, segment) in segments.Select((s, index) => (index, s)))
{
var durationOffset = TimeSpan.FromMilliseconds(i * segmentDuration.TotalMilliseconds);
@@ -91,9 +99,88 @@ foreach (var (i, segment) in segments.Select((s, index) => (index, s)))
segmentTranscription.AppendLine(CultureInfo.CurrentCulture, $"[{startTime:hh\\:mm\\:ss} - {endTime:hh\\:mm\\:ss}] {result.Text}");
}
- await File.AppendAllTextAsync("transcription.txt", segmentTranscription.ToString());
+ completeTranscription.Append(segmentTranscription);
}
// Step 5: Send the transcription to LLM for analysis
+// TODO: Explore this prompt further...seems break
+// when transcription is long
+var prompt = $"""
+You are an expert in identifying engaging segments from YouTube live stream transcriptions that are suitable for creating short videos. You will be provided with a transcription of a YouTube live stream. Your task is to analyze the transcription and identify potential segments that would make compelling short videos.
-// Step 6: Use analysis to generate a short video
\ No newline at end of file
+For each segment you identify, you should create an object with the following attributes:
+
+title: A concise and catchy title for the short video.
+description: A brief description of the short video's content.
+explanation: Explain why this segment would make a good short video (e.g., it's funny, informative, controversial, etc.).
+start_time: The timestamp in the format HH:MM:SS where the segment begins in the original live stream.
+end_time: The timestamp in the format HH:MM:SS where the segment ends in the original live stream.
+Your response must be a JSON array of these objects. The JSON array should be the only output. Do not include any introductory or explanatory text outside of the JSON array.
+
+Here is the transcription of the YouTube live stream:
+
+{completeTranscription}
+""";
+
+using var client = new HttpClient()
+{
+ Timeout = TimeSpan.FromMinutes(30)
+};
+using var request = new HttpRequestMessage(HttpMethod.Post, "http://localhost:11434/api/generate")
+{
+ Content = new StringContent(
+ JsonSerializer.Serialize(new
+ {
+ model = "llama3.1:latest",
+ prompt,
+ stream = false
+ }),
+ Encoding.UTF8,
+ "application/json"
+ )
+};
+var response = await client.SendAsync(request);
+var responseContent = await response.Content.ReadAsStringAsync();
+var responseJson = JsonSerializer.Deserialize(responseContent);
+var analysis = JsonSerializer.Deserialize>(responseJson?.Response ?? string.Empty);
+
+if (analysis is null)
+{
+ Console.WriteLine(resourceManager.GetString("LLMAnalysisFailed", CultureInfo.CurrentCulture));
+ return;
+}
+
+foreach (var result in analysis)
+{
+ var fileName = string.Concat(result.Title.Split(Path.GetInvalidFileNameChars()));
+ await FFMpeg.SubVideoAsync(
+ args[0],
+ $"{fileName}.mp4",
+ result.StartTime,
+ result.EndTime
+ );
+}
+
+
+stopwatch.Stop();
+Console.WriteLine(stopwatch.Elapsed.Minutes);
+
+// Step 6: Use analysis to generate a short video
+
+record LLMAnalysis(
+ [property: JsonPropertyName("title")]
+ string Title,
+ [property: JsonPropertyName("description")]
+ string Description,
+ [property: JsonPropertyName("explanation")]
+ string Explanation,
+ [property: JsonPropertyName("start_time")]
+ TimeSpan StartTime,
+ [property: JsonPropertyName("end_time")]
+ TimeSpan EndTime
+);
+
+record LLMResponse(
+ [property: JsonPropertyName("response")]
+ string Response
+);
\ No newline at end of file
From cd94b703bb58bf40ddc40de18a9aaa4bd28a8028 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Wed, 23 Jul 2025 02:16:48 -0500
Subject: [PATCH 03/24] fix: it works, but needed to switch local LLM for
hosted one.
---
src/Directory.packages.props | 2 +
src/StreamShorts.Console/Program.cs | 100 ++++++++++++++----
.../StreamShorts.Console.csproj | 7 ++
3 files changed, 91 insertions(+), 18 deletions(-)
diff --git a/src/Directory.packages.props b/src/Directory.packages.props
index 46ac85d..5ce8323 100644
--- a/src/Directory.packages.props
+++ b/src/Directory.packages.props
@@ -4,6 +4,8 @@
diff --git a/src/StreamShorts.Console/Program.cs b/src/StreamShorts.Console/Program.cs
index 7dcaacd..941144b 100644
--- a/src/StreamShorts.Console/Program.cs
+++ b/src/StreamShorts.Console/Program.cs
@@ -9,11 +9,16 @@ using FFMpegCore;
using FFMpegCore.Enums;
using FFMpegCore.Pipes;
+using Microsoft.Extensions.Configuration;
+
using NAudio.Wave;
using Whisper.net;
using Whisper.net.Ggml;
+var config = new ConfigurationBuilder()
+ .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
+ .Build();
var stopwatch = new Stopwatch();
stopwatch.Start();
@@ -105,35 +110,73 @@ foreach (var (i, segment) in segments.Select((s, index) => (index, s)))
// Step 5: Send the transcription to LLM for analysis
// TODO: Explore this prompt further...seems break
// when transcription is long
-var prompt = $"""
-You are an expert in identifying engaging segments from YouTube live stream transcriptions that are suitable for creating short videos. You will be provided with a transcription of a YouTube live stream. Your task is to analyze the transcription and identify potential segments that would make compelling short videos.
+var prompt = $$"""
+I need your help to transform my YouTube live stream transcript into engaging YouTube Shorts. Act as my content editor and pinpoint **all potential candidate segments** that are perfect for short-form video. I'm looking for clips that are:
-For each segment you identify, you should create an object with the following attributes:
+ * **Funny:** Moments that will make viewers laugh.
+ * **Informative:** Sections packed with valuable information or tips.
+ * **Insightful:** Portions offering unique perspectives or 'aha\!' moments.
-title: A concise and catchy title for the short video.
-description: A brief description of the short video's content.
-explanation: Explain why this segment would make a good short video (e.g., it's funny, informative, controversial, etc.).
-start_time: The timestamp in the format HH:MM:SS where the segment begins in the original live stream.
-end_time: The timestamp in the format HH:MM:SS where the segment ends in the original live stream.
-Your response must be a JSON array of these objects. The JSON array should be the only output. Do not include any introductory or explanatory text outside of the JSON array.
+For each suggested short, please provide:
-Here is the transcription of the YouTube live stream:
+ * The **start time** of the initial segment and the **end time** of the final segment. The duration of each short should be no longer than 3 minutes, but **aim for durations between 15 seconds and 60 seconds**. However, the short **must be as long as necessary to capture the complete thought or idea**, even if it means exceeding the target range or extending slightly to capture all necessary dialogue.
+ * A concise **title** that grabs attention.
+ * A brief **description** highlighting the short's content and its appeal.
+ * An **explanation** of why this particular segment is suitable for a YouTube Short, focusing on its potential for discoverability and engagement.
-{completeTranscription}
+Please format your response as a JSON array of objects with the following structure:
+
+```json
+{
+ ""title"": ""string"",
+ "start_time": "string",
+ "end_time": "string",
+ "description": "string",
+ "explanation": "string"
+}
+```
+
+Here is the transcript of my YouTube live stream:
+
+{{completeTranscription}}
""";
+var apiKey = config["GeminiApiKey"];
+
+if (string.IsNullOrWhiteSpace(apiKey))
+{
+ throw new InvalidOperationException("GeminiApiKey is not configured in appsettings.json.");
+}
+
using var client = new HttpClient()
{
Timeout = TimeSpan.FromMinutes(30)
};
-using var request = new HttpRequestMessage(HttpMethod.Post, "http://localhost:11434/api/generate")
+
+var requestUrl = $"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent?key={apiKey}";
+using var request = new HttpRequestMessage(HttpMethod.Post, requestUrl)
{
Content = new StringContent(
JsonSerializer.Serialize(new
{
- model = "llama3.1:latest",
- prompt,
- stream = false
+ contents = new[]
+ {
+ new
+ {
+ role = "user",
+ parts = new[]
+ {
+ new
+ {
+ text = prompt
+ }
+ },
+ }
+ },
+ generationConfig = new
+ {
+ responseMimeType = "application/json",
+ }
}),
Encoding.UTF8,
"application/json"
@@ -142,7 +185,13 @@ using var request = new HttpRequestMessage(HttpMethod.Post, "http://localhost:11
var response = await client.SendAsync(request);
var responseContent = await response.Content.ReadAsStringAsync();
var responseJson = JsonSerializer.Deserialize(responseContent);
-var analysis = JsonSerializer.Deserialize>(responseJson?.Response ?? string.Empty);
+var candidatesText = responseJson?
+ .Candidates?
+ .FirstOrDefault()?
+ .Content
+ .Parts?.FirstOrDefault()?
+ .Text;
+var analysis = JsonSerializer.Deserialize>(candidatesText ?? string.Empty);
if (analysis is null)
{
@@ -181,6 +230,21 @@ record LLMAnalysis(
);
record LLMResponse(
- [property: JsonPropertyName("response")]
- string Response
+ [property: JsonPropertyName("candidates")]
+ Candidate[] Candidates
+);
+
+record Candidate(
+ [property: JsonPropertyName("content")]
+ Content Content
+);
+
+record Content(
+ [property: JsonPropertyName("parts")]
+ Part[] Parts
+);
+
+record Part(
+ [property: JsonPropertyName("text")]
+ string Text
);
\ No newline at end of file
diff --git a/src/StreamShorts.Console/StreamShorts.Console.csproj b/src/StreamShorts.Console/StreamShorts.Console.csproj
index 38b1fd9..9e98856 100644
--- a/src/StreamShorts.Console/StreamShorts.Console.csproj
+++ b/src/StreamShorts.Console/StreamShorts.Console.csproj
@@ -6,8 +6,15 @@
+
+
+ PreserveNewest
+
+
From 310f56fb84519c4267e4044b995c921463920235 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Wed, 23 Jul 2025 23:55:56 -0500
Subject: [PATCH 04/24] feat: wip...migrating to proper app
---
.editorconfig | 6 +-
src/Directory.packages.props | 8 ++
src/StreamShorts.Console/.editorconfig | 2 +-
.../Commands/DefaultCommand.cs | 45 ++++++++++
.../Hosting/HostBuilderExtensions.cs | 21 +++++
.../Hosting/TypeRegistrar.cs | 28 ++++++
.../Hosting/TypeResolver.cs | 16 ++++
src/StreamShorts.Console/Program.cs | 64 ++++++++------
.../Resources/Resources.resx | 12 ---
.../StreamShorts.Console.csproj | 8 ++
src/StreamShorts.Console/Usings.cs | 18 ++++
.../Media/Audio/IAudioExtractor.cs | 0
.../Media/Video/IShortsCreator.cs | 0
tests/.editorconfig | 2 +
tests/Directory.Packages.props | 22 ++---
.../StreamShorts.Console.Tests.csproj | 3 +
.../Unit/Hosting/TypeRegistrarTests.cs | 88 +++++++++++++++++++
.../Unit/Hosting/TypeResolverTests.cs | 73 +++++++++++++++
tests/StreamShorts.Console.Tests/UnitTest1.cs | 10 ---
tests/StreamShorts.Console.Tests/Usings.cs | 8 ++
20 files changed, 370 insertions(+), 64 deletions(-)
create mode 100644 src/StreamShorts.Console/Commands/DefaultCommand.cs
create mode 100644 src/StreamShorts.Console/Hosting/HostBuilderExtensions.cs
create mode 100644 src/StreamShorts.Console/Hosting/TypeRegistrar.cs
create mode 100644 src/StreamShorts.Console/Hosting/TypeResolver.cs
delete mode 100644 src/StreamShorts.Console/Resources/Resources.resx
create mode 100644 src/StreamShorts.Console/Usings.cs
create mode 100644 src/StreamShorts.Library/Media/Audio/IAudioExtractor.cs
create mode 100644 src/StreamShorts.Library/Media/Video/IShortsCreator.cs
create mode 100644 tests/.editorconfig
create mode 100644 tests/StreamShorts.Console.Tests/Unit/Hosting/TypeRegistrarTests.cs
create mode 100644 tests/StreamShorts.Console.Tests/Unit/Hosting/TypeResolverTests.cs
delete mode 100644 tests/StreamShorts.Console.Tests/UnitTest1.cs
create mode 100644 tests/StreamShorts.Console.Tests/Usings.cs
diff --git a/.editorconfig b/.editorconfig
index 398cb36..0adf1e7 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -23,6 +23,10 @@ insert_final_newline = false
#### .NET Coding Conventions ####
[*.{cs,vb}]
+# Diagnostic severity preferences
+dotnet_diagnostic.IDE0058.severity = none
+dotnet_diagnostic.IDE0100.severity = none
+
# Organize usings
dotnet_separate_import_directive_groups = true
dotnet_sort_system_directives_first = true
@@ -59,7 +63,7 @@ dotnet_style_prefer_auto_properties = true:suggestion
dotnet_style_prefer_collection_expression = when_types_loosely_match:suggestion
dotnet_style_prefer_compound_assignment = true:suggestion
dotnet_style_prefer_conditional_expression_over_assignment = true:suggestion
-dotnet_style_prefer_conditional_expression_over_return = true:suggestion
+dotnet_style_prefer_conditional_expression_over_return = false:silent
dotnet_style_prefer_foreach_explicit_cast_in_source = when_strongly_typed:suggestion
dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
dotnet_style_prefer_inferred_tuple_names = true:suggestion
diff --git a/src/Directory.packages.props b/src/Directory.packages.props
index 5ce8323..0f718b5 100644
--- a/src/Directory.packages.props
+++ b/src/Directory.packages.props
@@ -6,7 +6,15 @@
+{
+ private readonly IFileSystem _fileSystem = fileSystem ?? throw new ArgumentNullException(nameof(fileSystem));
+ private readonly IAnsiConsole _console = console ?? throw new ArgumentNullException(nameof(console));
+
+ internal class Settings : CommandSettings
+ {
+ [CommandArgument(0, "[Stream]")]
+ [Description("The path to the stream")]
+ public string Stream { get; init; } = string.Empty;
+ }
+
+ public override ValidationResult Validate(CommandContext context, Settings settings)
+ {
+ if (string.IsNullOrWhiteSpace(settings.Stream))
+ {
+ return ValidationResult.Error("Stream path must be provided.");
+ }
+
+ if (_fileSystem.File.Exists(settings.Stream) is false)
+ {
+ return ValidationResult.Error($"The specified stream file '{settings.Stream}' does not exist.");
+ }
+
+ var fileExtension = _fileSystem.Path.GetExtension(settings.Stream).ToUpperInvariant();
+
+ if (fileExtension != ".MP4")
+ {
+ return ValidationResult.Error("The specified stream file must be an .mp4 file.");
+ }
+
+ return base.Validate(context, settings);
+ }
+
+ public override Task ExecuteAsync(CommandContext context, Settings settings)
+ {
+ _console.Write($"[green]Processing stream:[/] {settings.Stream}");
+ return Task.FromResult(0);
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Hosting/HostBuilderExtensions.cs b/src/StreamShorts.Console/Hosting/HostBuilderExtensions.cs
new file mode 100644
index 0000000..4b4bdd6
--- /dev/null
+++ b/src/StreamShorts.Console/Hosting/HostBuilderExtensions.cs
@@ -0,0 +1,21 @@
+namespace StreamShorts.Console.Hosting;
+
+internal static class HostBuilderExtensions
+{
+ public static CommandApp BuildApp(this IHostBuilder builder)
+ {
+ var registrar = new TypeRegistrar(builder);
+ var app = new CommandApp(registrar);
+
+ app.Configure(static c =>
+ c.SetExceptionHandler(static (ex, resolver) =>
+ {
+ var console = resolver?.Resolve(typeof(IAnsiConsole)) as IAnsiConsole;
+ console?.WriteLine($"[red]An error occurred while executing the command:[/]");
+ console?.WriteException(ex, ExceptionFormats.ShortenEverything);
+ })
+ );
+
+ return app;
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Hosting/TypeRegistrar.cs b/src/StreamShorts.Console/Hosting/TypeRegistrar.cs
new file mode 100644
index 0000000..50ab983
--- /dev/null
+++ b/src/StreamShorts.Console/Hosting/TypeRegistrar.cs
@@ -0,0 +1,28 @@
+namespace StreamShorts.Console.Hosting;
+
+internal class TypeRegistrar(IHostBuilder builder) : ITypeRegistrar
+{
+ private readonly IHostBuilder _builder = builder;
+
+ public ITypeResolver Build()
+ {
+ return new TypeResolver(_builder.Build());
+ }
+
+ public void Register(Type service, Type implementation)
+ {
+ _builder.ConfigureServices((_, services) => services.AddSingleton(service, implementation));
+ }
+
+ public void RegisterInstance(Type service, object implementation)
+ {
+ _builder.ConfigureServices((_, services) => services.AddSingleton(service, implementation));
+ }
+
+ public void RegisterLazy(Type service, Func func)
+ {
+ ArgumentNullException.ThrowIfNull(func);
+
+ _builder.ConfigureServices((_, services) => services.AddSingleton(service, _ => func()));
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Hosting/TypeResolver.cs b/src/StreamShorts.Console/Hosting/TypeResolver.cs
new file mode 100644
index 0000000..afbb21b
--- /dev/null
+++ b/src/StreamShorts.Console/Hosting/TypeResolver.cs
@@ -0,0 +1,16 @@
+namespace StreamShorts.Console.Hosting;
+
+internal class TypeResolver(IHost provider) : ITypeResolver, IDisposable
+{
+ private readonly IHost _host = provider ?? throw new ArgumentNullException(nameof(provider));
+
+ public object? Resolve(Type? type)
+ {
+ return type is not null ? _host.Services.GetService(type) : null;
+ }
+
+ public void Dispose()
+ {
+ _host.Dispose();
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Program.cs b/src/StreamShorts.Console/Program.cs
index 941144b..53065ed 100644
--- a/src/StreamShorts.Console/Program.cs
+++ b/src/StreamShorts.Console/Program.cs
@@ -1,5 +1,4 @@
-using System.Diagnostics;
-using System.Globalization;
+using System.Globalization;
using System.Resources;
using System.Text;
using System.Text.Json;
@@ -9,28 +8,47 @@ using FFMpegCore;
using FFMpegCore.Enums;
using FFMpegCore.Pipes;
-using Microsoft.Extensions.Configuration;
-
using NAudio.Wave;
using Whisper.net;
using Whisper.net.Ggml;
-var config = new ConfigurationBuilder()
- .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
- .Build();
+Log.Logger = new LoggerConfiguration()
+ .WriteTo.File(
+ formatter: new CompactJsonFormatter(),
+ path: Path.Combine(AppContext.BaseDirectory, "logs", "log.jsonl"),
+ rollingInterval: RollingInterval.Day
+ )
+ .Enrich.FromLogContext()
+ .MinimumLevel.Verbose()
+ .MinimumLevel.Override("Microsoft", LogEventLevel.Fatal)
+ .CreateLogger();
-var stopwatch = new Stopwatch();
-stopwatch.Start();
-var resourceManager = new ResourceManager("StreamShorts.Console.Resources.Resources", typeof(Program).Assembly);
-
-Console.WriteLine(resourceManager.GetString("WelcomeMessage", CultureInfo.CurrentCulture));
-
-// Step 1: Retrieve stream
-if (args.Length is 0)
+try
{
- Console.WriteLine(resourceManager.GetString("StreamNotProvided", CultureInfo.CurrentCulture));
- return;
+ var appName = Assembly.GetExecutingAssembly().GetName().Name;
+ Log.Information("Starting {AppName}", appName);
+
+ await Host.CreateDefaultBuilder(args)
+ .ConfigureLogging(static l => l.ClearProviders())
+ .ConfigureServices(static (_, services) =>
+ {
+ services.AddSingleton(AnsiConsole.Console);
+ services.AddSingleton();
+ })
+ .BuildApp()
+ .RunAsync(args);
+
+ Log.Information("{AppName} has completed successfully.", appName);
+}
+catch (Exception ex)
+{
+ Log.Fatal(ex, "An unhandled exception occurred during execution.");
+ throw;
+}
+finally
+{
+ await Log.CloseAndFlushAsync();
}
using var mp3Stream = new MemoryStream();
@@ -44,12 +62,6 @@ var wasExtracted = await FFMpegArguments
)
.ProcessAsynchronously();
-if (wasExtracted is false)
-{
- Console.WriteLine(resourceManager.GetString("Mp3ExtractionFailed", CultureInfo.CurrentCulture));
- return;
-}
-
// Step 2: Convert MP3 stream to 16khz wave format
mp3Stream.Position = 0;
using var reader = new Mp3FileReader(mp3Stream);
@@ -141,8 +153,6 @@ Here is the transcript of my YouTube live stream:
{{completeTranscription}}
""";
-var apiKey = config["GeminiApiKey"];
-
if (string.IsNullOrWhiteSpace(apiKey))
{
throw new InvalidOperationException("GeminiApiKey is not configured in appsettings.json.");
@@ -210,10 +220,6 @@ foreach (var result in analysis)
);
}
-
-stopwatch.Stop();
-Console.WriteLine(stopwatch.Elapsed.Minutes);
-
// Step 6: Use analysis to generate a short video
record LLMAnalysis(
diff --git a/src/StreamShorts.Console/Resources/Resources.resx b/src/StreamShorts.Console/Resources/Resources.resx
deleted file mode 100644
index c866a39..0000000
--- a/src/StreamShorts.Console/Resources/Resources.resx
+++ /dev/null
@@ -1,12 +0,0 @@
-
-
-
- Welcome to StreamShorts!
-
-
- No stream provided. Please specify a stream to process.
-
-
- Failed to extract MP3 from the provided stream.
-
-
\ No newline at end of file
diff --git a/src/StreamShorts.Console/StreamShorts.Console.csproj b/src/StreamShorts.Console/StreamShorts.Console.csproj
index 9e98856..bd4e7f4 100644
--- a/src/StreamShorts.Console/StreamShorts.Console.csproj
+++ b/src/StreamShorts.Console/StreamShorts.Console.csproj
@@ -8,7 +8,15 @@
-
-
- true
-
-
-
-
-
+
+ true
+
+
+
\ No newline at end of file
diff --git a/tests/StreamShorts.Console.Tests/StreamShorts.Console.Tests.csproj b/tests/StreamShorts.Console.Tests/StreamShorts.Console.Tests.csproj
index e42006f..5378526 100644
--- a/tests/StreamShorts.Console.Tests/StreamShorts.Console.Tests.csproj
+++ b/tests/StreamShorts.Console.Tests/StreamShorts.Console.Tests.csproj
@@ -1,7 +1,10 @@
+
diff --git a/tests/StreamShorts.Console.Tests/Unit/Hosting/TypeRegistrarTests.cs b/tests/StreamShorts.Console.Tests/Unit/Hosting/TypeRegistrarTests.cs
new file mode 100644
index 0000000..1b76528
--- /dev/null
+++ b/tests/StreamShorts.Console.Tests/Unit/Hosting/TypeRegistrarTests.cs
@@ -0,0 +1,88 @@
+namespace StreamShorts.Console.Tests.Unit.Hosting;
+
+public class TypeRegistrarTests
+{
+ [Fact]
+ public void Constructor_WhenCalled_ItShouldNotThrowShould()
+ {
+ var mockBuilder = new Mock();
+
+ var action = () => new TypeRegistrar(mockBuilder.Object);
+
+ action.Should().NotThrow();
+ }
+
+ [Fact]
+ public void Build_WhenCalled_ItShouldReturnResolverAndBuildHost()
+ {
+ var mockHost = new Mock();
+ var mockBuilder = new Mock();
+
+ mockBuilder
+ .Setup(static b => b.Build())
+ .Returns(mockHost.Object);
+
+ var registrar = new TypeRegistrar(mockBuilder.Object);
+
+ var resolver = registrar.Build();
+
+ resolver.Should().BeOfType();
+ mockBuilder.Verify(static b => b.Build(), Times.Once);
+ }
+
+ [Fact]
+ public void Register_WhenCalledWithType_ItShouldAddToContainer()
+ {
+ var builder = Host.CreateDefaultBuilder();
+ var registrar = new TypeRegistrar(builder);
+ registrar.Register(typeof(IService), typeof(ServiceImplementation));
+
+ using var host = builder.Build();
+ var service = host.Services.GetService();
+
+ service.Should().NotBeNull();
+ service.Should().BeOfType();
+ }
+
+ [Fact]
+ public void RegisterInstance_WhenCalledWithInstance_ItShouldAddToContainer()
+ {
+ var builder = Host.CreateDefaultBuilder();
+ var registrar = new TypeRegistrar(builder);
+ var instance = new ServiceImplementation();
+ registrar.RegisterInstance(typeof(IService), instance);
+
+ using var host = builder.Build();
+ var service = host.Services.GetService();
+
+ service.Should().BeSameAs(instance);
+ }
+
+ [Fact]
+ public void RegisterLazy_WhenCalledWithFunc_ItShouldAddToContainer()
+ {
+ var builder = Host.CreateDefaultBuilder();
+ var registrar = new TypeRegistrar(builder);
+ registrar.RegisterLazy(typeof(IService), static () => new ServiceImplementation());
+
+ using var host = builder.Build();
+ var service = host.Services.GetService();
+
+ service.Should().NotBeNull();
+ service.Should().BeOfType();
+ }
+
+ [Fact]
+ public void RegisterLazy_WhenFuncIsNull_ItShouldThrow()
+ {
+ var builder = Host.CreateDefaultBuilder();
+ var registrar = new TypeRegistrar(builder);
+
+ var action = () => registrar.RegisterLazy(typeof(IService), null!);
+
+ action.Should().Throw();
+ }
+
+ private interface IService { }
+ private sealed class ServiceImplementation : IService { }
+}
\ No newline at end of file
diff --git a/tests/StreamShorts.Console.Tests/Unit/Hosting/TypeResolverTests.cs b/tests/StreamShorts.Console.Tests/Unit/Hosting/TypeResolverTests.cs
new file mode 100644
index 0000000..8cfaf73
--- /dev/null
+++ b/tests/StreamShorts.Console.Tests/Unit/Hosting/TypeResolverTests.cs
@@ -0,0 +1,73 @@
+namespace StreamShorts.Console.Tests.Unit.Hosting;
+
+public class TypeResolverTests
+{
+ [Fact]
+ public void Constructor_WhenCalledWithNullHost_ItShouldThrowArgumentNullException()
+ {
+ var action = static () => new TypeResolver(null!);
+
+ action.Should().Throw();
+ }
+
+ [Fact]
+ public void Resolve_WhenTypeIsNull_ItShouldReturnNull()
+ {
+ var mockHost = new Mock();
+ using var resolver = new TypeResolver(mockHost.Object);
+
+ var result = resolver.Resolve(null);
+
+ result.Should().BeNull();
+ }
+
+ [Fact]
+ public void Resolve_WhenCalledWithRegisteredType_ItShouldReturnAnInstance()
+ {
+ var services = new ServiceCollection();
+ services.AddSingleton(new TestService());
+
+ var mockHost = new Mock();
+
+ mockHost
+ .Setup(static h => h.Services)
+ .Returns(services.BuildServiceProvider());
+
+ using var resolver = new TypeResolver(mockHost.Object);
+
+ var result = resolver.Resolve(typeof(TestService));
+
+ result.Should().NotBeNull();
+ result.Should().BeOfType();
+ }
+
+ [Fact]
+ public void Resolve_WhenCalledWithUnregisteredType_ItShouldReturnNull()
+ {
+ var services = new ServiceCollection();
+ var mockHost = new Mock();
+
+ mockHost
+ .Setup(static h => h.Services)
+ .Returns(services.BuildServiceProvider());
+
+ using var resolver = new TypeResolver(mockHost.Object);
+
+ var result = resolver.Resolve(typeof(TestService));
+
+ result.Should().BeNull();
+ }
+
+ [Fact]
+ public void Dispose_WhenCalled_ItShouldAlsoDisposeHost()
+ {
+ var mockHost = new Mock();
+ var resolver = new TypeResolver(mockHost.Object);
+
+ resolver.Dispose();
+
+ mockHost.Verify(static h => h.Dispose(), Times.Once);
+ }
+
+ private sealed class TestService { }
+}
\ No newline at end of file
diff --git a/tests/StreamShorts.Console.Tests/UnitTest1.cs b/tests/StreamShorts.Console.Tests/UnitTest1.cs
deleted file mode 100644
index 09cad2e..0000000
--- a/tests/StreamShorts.Console.Tests/UnitTest1.cs
+++ /dev/null
@@ -1,10 +0,0 @@
-namespace StreamShorts.Console.Tests;
-
-public class UnitTest1
-{
- [Fact]
- public void Test1()
- {
- Assert.True(true);
- }
-}
diff --git a/tests/StreamShorts.Console.Tests/Usings.cs b/tests/StreamShorts.Console.Tests/Usings.cs
new file mode 100644
index 0000000..7c8e815
--- /dev/null
+++ b/tests/StreamShorts.Console.Tests/Usings.cs
@@ -0,0 +1,8 @@
+global using AwesomeAssertions;
+
+global using Microsoft.Extensions.DependencyInjection;
+global using Microsoft.Extensions.Hosting;
+
+global using Moq;
+
+global using StreamShorts.Console.Hosting;
From 0a661d6970f768ae1a3a9ce5317ea7399f5a4523 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Thu, 24 Jul 2025 11:22:15 -0500
Subject: [PATCH 05/24] feat: refactor audio extraction to reusable class
---
.editorconfig | 1 +
src/Directory.packages.props | 1 +
.../Commands/DefaultCommand.cs | 29 +-
src/StreamShorts.Console/Program.cs | 350 +++++++++---------
.../StreamShorts.Console.csproj | 4 +
src/StreamShorts.Console/Usings.cs | 4 +-
.../Media/Audio/AudioExtractor.cs | 63 ++++
.../Audio/FailedAudioExtractionException.cs | 16 +
.../Media/Audio/IAudioExtractor.cs | 19 +
.../StreamShorts.Library.csproj | 4 +-
tests/.editorconfig | 1 +
.../StreamShorts.Library.Tests.csproj | 2 +
.../Unit/Media/Audio/AudioExtractorTests.cs | 36 ++
tests/StreamShorts.Library.Tests/Usings.cs | 5 +
14 files changed, 354 insertions(+), 181 deletions(-)
create mode 100644 src/StreamShorts.Library/Media/Audio/AudioExtractor.cs
create mode 100644 src/StreamShorts.Library/Media/Audio/FailedAudioExtractionException.cs
create mode 100644 tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs
create mode 100644 tests/StreamShorts.Library.Tests/Usings.cs
diff --git a/.editorconfig b/.editorconfig
index 0adf1e7..b4b5c8a 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -26,6 +26,7 @@ insert_final_newline = false
# Diagnostic severity preferences
dotnet_diagnostic.IDE0058.severity = none
dotnet_diagnostic.IDE0100.severity = none
+dotnet_diagnostic.CA1848.severity = none
# Organize usings
dotnet_separate_import_directive_groups = true
diff --git a/src/Directory.packages.props b/src/Directory.packages.props
index 0f718b5..a2138ae 100644
--- a/src/Directory.packages.props
+++ b/src/Directory.packages.props
@@ -7,6 +7,7 @@
{
private readonly IFileSystem _fileSystem = fileSystem ?? throw new ArgumentNullException(nameof(fileSystem));
private readonly IAnsiConsole _console = console ?? throw new ArgumentNullException(nameof(console));
+ private readonly IAudioExtractor _audioExtractor = audioExtractor ?? throw new ArgumentNullException(nameof(audioExtractor));
internal class Settings : CommandSettings
{
@@ -37,9 +39,28 @@ internal class DefaultCommand(
return base.Validate(context, settings);
}
- public override Task ExecuteAsync(CommandContext context, Settings settings)
+ public override async Task ExecuteAsync(CommandContext context, Settings settings)
{
- _console.Write($"[green]Processing stream:[/] {settings.Stream}");
- return Task.FromResult(0);
+ _console.MarkupLine($"[blue]Processing stream:[/] {settings.Stream}");
+ var videoStream = _fileSystem.File.OpenRead(settings.Stream);
+
+ Stream? audioStream = null;
+
+ await _console.Status()
+ .Spinner(Spinner.Known.Dots)
+ .StartAsync("Extracting audio...", async ctx =>
+ {
+ audioStream = await _audioExtractor.ExtractMp3FromMp4Async(videoStream).ConfigureAwait(false);
+ });
+
+ if (audioStream is null)
+ {
+ _console.MarkupLine("[red]Failed[/] to extract audio from the stream.");
+ return 1;
+ }
+
+ _console.MarkupLine($"[blue]Audio extracted[/] [green]successfully![/]");
+
+ return 0;
}
}
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Program.cs b/src/StreamShorts.Console/Program.cs
index 53065ed..8d518aa 100644
--- a/src/StreamShorts.Console/Program.cs
+++ b/src/StreamShorts.Console/Program.cs
@@ -10,6 +10,7 @@ using FFMpegCore.Pipes;
using NAudio.Wave;
+
using Whisper.net;
using Whisper.net.Ggml;
@@ -35,6 +36,7 @@ try
{
services.AddSingleton(AnsiConsole.Console);
services.AddSingleton();
+ services.AddSingleton();
})
.BuildApp()
.RunAsync(args);
@@ -51,206 +53,206 @@ finally
await Log.CloseAndFlushAsync();
}
-using var mp3Stream = new MemoryStream();
-using var mp4Stream = new FileStream(args[0], FileMode.Open, FileAccess.Read);
+// using var mp3Stream = new MemoryStream();
+// using var mp4Stream = new FileStream(args[0], FileMode.Open, FileAccess.Read);
-var wasExtracted = await FFMpegArguments
- .FromPipeInput(new StreamPipeSource(mp4Stream))
- .OutputToPipe(
- new StreamPipeSink(mp3Stream),
- o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
- )
- .ProcessAsynchronously();
+// var wasExtracted = await FFMpegArguments
+// .FromPipeInput(new StreamPipeSource(mp4Stream))
+// .OutputToPipe(
+// new StreamPipeSink(mp3Stream),
+// o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
+// )
+// .ProcessAsynchronously();
-// Step 2: Convert MP3 stream to 16khz wave format
-mp3Stream.Position = 0;
-using var reader = new Mp3FileReader(mp3Stream);
-var outFormat = new WaveFormat(16000, reader.WaveFormat.Channels);
-using var resampler = new MediaFoundationResampler(reader, outFormat);
-using var waveStream = new MemoryStream();
-WaveFileWriter.WriteWavFileToStream(waveStream, resampler);
+// // Step 2: Convert MP3 stream to 16khz wave format
+// mp3Stream.Position = 0;
+// using var reader = new Mp3FileReader(mp3Stream);
+// var outFormat = new WaveFormat(16000, reader.WaveFormat.Channels);
+// using var resampler = new MediaFoundationResampler(reader, outFormat);
+// using var waveStream = new MemoryStream();
+// WaveFileWriter.WriteWavFileToStream(waveStream, resampler);
-// Step 3: Split the wave stream into 2 minute segments
-waveStream.Position = 0;
-var segmentDuration = TimeSpan.FromMinutes(2);
-var segments = new List();
-using var waveReader = new WaveFileReader(waveStream);
-var segmentCount = (int)Math.Ceiling(waveReader.TotalTime.TotalMilliseconds / segmentDuration.TotalMilliseconds);
+// // Step 3: Split the wave stream into 2 minute segments
+// waveStream.Position = 0;
+// var segmentDuration = TimeSpan.FromMinutes(2);
+// var segments = new List();
+// using var waveReader = new WaveFileReader(waveStream);
+// var segmentCount = (int)Math.Ceiling(waveReader.TotalTime.TotalMilliseconds / segmentDuration.TotalMilliseconds);
-Directory.CreateDirectory("segments");
+// Directory.CreateDirectory("segments");
-foreach (var i in Enumerable.Range(0, segmentCount))
-{
- waveStream.Position = 0;
- using var segmentWaveReader = new WaveFileReader(waveStream);
- var segment = segmentWaveReader.ToSampleProvider()
- .Skip(i * segmentDuration)
- .Take(segmentDuration);
- var segmentProvider = segment.ToWaveProvider16();
- var segmentStream = new MemoryStream();
- WaveFileWriter.WriteWavFileToStream(segmentStream, segmentProvider);
- segmentStream.Position = 0;
- segments.Add(segmentStream);
-}
+// foreach (var i in Enumerable.Range(0, segmentCount))
+// {
+// waveStream.Position = 0;
+// using var segmentWaveReader = new WaveFileReader(waveStream);
+// var segment = segmentWaveReader.ToSampleProvider()
+// .Skip(i * segmentDuration)
+// .Take(segmentDuration);
+// var segmentProvider = segment.ToWaveProvider16();
+// var segmentStream = new MemoryStream();
+// WaveFileWriter.WriteWavFileToStream(segmentStream, segmentProvider);
+// segmentStream.Position = 0;
+// segments.Add(segmentStream);
+// }
-// Step 4: Transcribe each segment using Whisper
-using var modelMemoryStream = new MemoryStream();
-var model = await WhisperGgmlDownloader.Default.GetGgmlModelAsync(GgmlType.TinyEn);
-await model.CopyToAsync(modelMemoryStream);
-var whisperFactory = WhisperFactory.FromBuffer(modelMemoryStream.ToArray());
-using var whisperProcessor = whisperFactory.CreateBuilder()
- .WithLanguage("en")
- .Build();
+// // Step 4: Transcribe each segment using Whisper
+// using var modelMemoryStream = new MemoryStream();
+// var model = await WhisperGgmlDownloader.Default.GetGgmlModelAsync(GgmlType.TinyEn);
+// await model.CopyToAsync(modelMemoryStream);
+// var whisperFactory = WhisperFactory.FromBuffer(modelMemoryStream.ToArray());
+// using var whisperProcessor = whisperFactory.CreateBuilder()
+// .WithLanguage("en")
+// .Build();
-var completeTranscription = new StringBuilder();
+// var completeTranscription = new StringBuilder();
-foreach (var (i, segment) in segments.Select((s, index) => (index, s)))
-{
- var durationOffset = TimeSpan.FromMilliseconds(i * segmentDuration.TotalMilliseconds);
- var segmentTranscription = new StringBuilder();
+// foreach (var (i, segment) in segments.Select((s, index) => (index, s)))
+// {
+// var durationOffset = TimeSpan.FromMilliseconds(i * segmentDuration.TotalMilliseconds);
+// var segmentTranscription = new StringBuilder();
- await foreach (var result in whisperProcessor.ProcessAsync(segment, CancellationToken.None))
- {
- var startTime = result.Start + durationOffset;
- var endTime = result.End + durationOffset;
- segmentTranscription.AppendLine(CultureInfo.CurrentCulture, $"[{startTime:hh\\:mm\\:ss} - {endTime:hh\\:mm\\:ss}] {result.Text}");
- }
+// await foreach (var result in whisperProcessor.ProcessAsync(segment, CancellationToken.None))
+// {
+// var startTime = result.Start + durationOffset;
+// var endTime = result.End + durationOffset;
+// segmentTranscription.AppendLine(CultureInfo.CurrentCulture, $"[{startTime:hh\\:mm\\:ss} - {endTime:hh\\:mm\\:ss}] {result.Text}");
+// }
- completeTranscription.Append(segmentTranscription);
-}
+// completeTranscription.Append(segmentTranscription);
+// }
-// Step 5: Send the transcription to LLM for analysis
-// TODO: Explore this prompt further...seems break
-// when transcription is long
-var prompt = $$"""
-I need your help to transform my YouTube live stream transcript into engaging YouTube Shorts. Act as my content editor and pinpoint **all potential candidate segments** that are perfect for short-form video. I'm looking for clips that are:
+// // Step 5: Send the transcription to LLM for analysis
+// // TODO: Explore this prompt further...seems break
+// // when transcription is long
+// var prompt = $$"""
+// I need your help to transform my YouTube live stream transcript into engaging YouTube Shorts. Act as my content editor and pinpoint **all potential candidate segments** that are perfect for short-form video. I'm looking for clips that are:
- * **Funny:** Moments that will make viewers laugh.
- * **Informative:** Sections packed with valuable information or tips.
- * **Insightful:** Portions offering unique perspectives or 'aha\!' moments.
+// * **Funny:** Moments that will make viewers laugh.
+// * **Informative:** Sections packed with valuable information or tips.
+// * **Insightful:** Portions offering unique perspectives or 'aha\!' moments.
-For each suggested short, please provide:
+// For each suggested short, please provide:
- * The **start time** of the initial segment and the **end time** of the final segment. The duration of each short should be no longer than 3 minutes, but **aim for durations between 15 seconds and 60 seconds**. However, the short **must be as long as necessary to capture the complete thought or idea**, even if it means exceeding the target range or extending slightly to capture all necessary dialogue.
- * A concise **title** that grabs attention.
- * A brief **description** highlighting the short's content and its appeal.
- * An **explanation** of why this particular segment is suitable for a YouTube Short, focusing on its potential for discoverability and engagement.
+// * The **start time** of the initial segment and the **end time** of the final segment. The duration of each short should be no longer than 3 minutes, but **aim for durations between 15 seconds and 60 seconds**. However, the short **must be as long as necessary to capture the complete thought or idea**, even if it means exceeding the target range or extending slightly to capture all necessary dialogue.
+// * A concise **title** that grabs attention.
+// * A brief **description** highlighting the short's content and its appeal.
+// * An **explanation** of why this particular segment is suitable for a YouTube Short, focusing on its potential for discoverability and engagement.
-Please format your response as a JSON array of objects with the following structure:
+// Please format your response as a JSON array of objects with the following structure:
-```json
-{
- ""title"": ""string"",
- "start_time": "string",
- "end_time": "string",
- "description": "string",
- "explanation": "string"
-}
-```
+// ```json
+// {
+// ""title"": ""string"",
+// "start_time": "string",
+// "end_time": "string",
+// "description": "string",
+// "explanation": "string"
+// }
+// ```
-Here is the transcript of my YouTube live stream:
+// Here is the transcript of my YouTube live stream:
-{{completeTranscription}}
-""";
+// {{completeTranscription}}
+// """;
-if (string.IsNullOrWhiteSpace(apiKey))
-{
- throw new InvalidOperationException("GeminiApiKey is not configured in appsettings.json.");
-}
+// if (string.IsNullOrWhiteSpace(apiKey))
+// {
+// throw new InvalidOperationException("GeminiApiKey is not configured in appsettings.json.");
+// }
-using var client = new HttpClient()
-{
- Timeout = TimeSpan.FromMinutes(30)
-};
+// using var client = new HttpClient()
+// {
+// Timeout = TimeSpan.FromMinutes(30)
+// };
-var requestUrl = $"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent?key={apiKey}";
-using var request = new HttpRequestMessage(HttpMethod.Post, requestUrl)
-{
- Content = new StringContent(
- JsonSerializer.Serialize(new
- {
- contents = new[]
- {
- new
- {
- role = "user",
- parts = new[]
- {
- new
- {
- text = prompt
- }
- },
- }
- },
- generationConfig = new
- {
- responseMimeType = "application/json",
- }
- }),
- Encoding.UTF8,
- "application/json"
- )
-};
-var response = await client.SendAsync(request);
-var responseContent = await response.Content.ReadAsStringAsync();
-var responseJson = JsonSerializer.Deserialize(responseContent);
-var candidatesText = responseJson?
- .Candidates?
- .FirstOrDefault()?
- .Content
- .Parts?.FirstOrDefault()?
- .Text;
-var analysis = JsonSerializer.Deserialize>(candidatesText ?? string.Empty);
+// var requestUrl = $"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent?key={apiKey}";
+// using var request = new HttpRequestMessage(HttpMethod.Post, requestUrl)
+// {
+// Content = new StringContent(
+// JsonSerializer.Serialize(new
+// {
+// contents = new[]
+// {
+// new
+// {
+// role = "user",
+// parts = new[]
+// {
+// new
+// {
+// text = prompt
+// }
+// },
+// }
+// },
+// generationConfig = new
+// {
+// responseMimeType = "application/json",
+// }
+// }),
+// Encoding.UTF8,
+// "application/json"
+// )
+// };
+// var response = await client.SendAsync(request);
+// var responseContent = await response.Content.ReadAsStringAsync();
+// var responseJson = JsonSerializer.Deserialize(responseContent);
+// var candidatesText = responseJson?
+// .Candidates?
+// .FirstOrDefault()?
+// .Content
+// .Parts?.FirstOrDefault()?
+// .Text;
+// var analysis = JsonSerializer.Deserialize>(candidatesText ?? string.Empty);
-if (analysis is null)
-{
- Console.WriteLine(resourceManager.GetString("LLMAnalysisFailed", CultureInfo.CurrentCulture));
- return;
-}
+// if (analysis is null)
+// {
+// Console.WriteLine(resourceManager.GetString("LLMAnalysisFailed", CultureInfo.CurrentCulture));
+// return;
+// }
-foreach (var result in analysis)
-{
- var fileName = string.Concat(result.Title.Split(Path.GetInvalidFileNameChars()));
- await FFMpeg.SubVideoAsync(
- args[0],
- $"{fileName}.mp4",
- result.StartTime,
- result.EndTime
- );
-}
+// foreach (var result in analysis)
+// {
+// var fileName = string.Concat(result.Title.Split(Path.GetInvalidFileNameChars()));
+// await FFMpeg.SubVideoAsync(
+// args[0],
+// $"{fileName}.mp4",
+// result.StartTime,
+// result.EndTime
+// );
+// }
-// Step 6: Use analysis to generate a short video
+// // Step 6: Use analysis to generate a short video
-record LLMAnalysis(
- [property: JsonPropertyName("title")]
- string Title,
- [property: JsonPropertyName("description")]
- string Description,
- [property: JsonPropertyName("explanation")]
- string Explanation,
- [property: JsonPropertyName("start_time")]
- TimeSpan StartTime,
- [property: JsonPropertyName("end_time")]
- TimeSpan EndTime
-);
+// record LLMAnalysis(
+// [property: JsonPropertyName("title")]
+// string Title,
+// [property: JsonPropertyName("description")]
+// string Description,
+// [property: JsonPropertyName("explanation")]
+// string Explanation,
+// [property: JsonPropertyName("start_time")]
+// TimeSpan StartTime,
+// [property: JsonPropertyName("end_time")]
+// TimeSpan EndTime
+// );
-record LLMResponse(
- [property: JsonPropertyName("candidates")]
- Candidate[] Candidates
-);
+// record LLMResponse(
+// [property: JsonPropertyName("candidates")]
+// Candidate[] Candidates
+// );
-record Candidate(
- [property: JsonPropertyName("content")]
- Content Content
-);
+// record Candidate(
+// [property: JsonPropertyName("content")]
+// Content Content
+// );
-record Content(
- [property: JsonPropertyName("parts")]
- Part[] Parts
-);
+// record Content(
+// [property: JsonPropertyName("parts")]
+// Part[] Parts
+// );
-record Part(
- [property: JsonPropertyName("text")]
- string Text
-);
\ No newline at end of file
+// record Part(
+// [property: JsonPropertyName("text")]
+// string Text
+// );
\ No newline at end of file
diff --git a/src/StreamShorts.Console/StreamShorts.Console.csproj b/src/StreamShorts.Console/StreamShorts.Console.csproj
index bd4e7f4..bfc9e32 100644
--- a/src/StreamShorts.Console/StreamShorts.Console.csproj
+++ b/src/StreamShorts.Console/StreamShorts.Console.csproj
@@ -25,4 +25,8 @@
PreserveNewest
+
+
+
diff --git a/src/StreamShorts.Console/Usings.cs b/src/StreamShorts.Console/Usings.cs
index 7f594c9..99671c7 100644
--- a/src/StreamShorts.Console/Usings.cs
+++ b/src/StreamShorts.Console/Usings.cs
@@ -2,7 +2,6 @@ global using System.ComponentModel;
global using System.IO.Abstractions;
global using System.Reflection;
-global using Microsoft.Extensions.Configuration;
global using Microsoft.Extensions.DependencyInjection;
global using Microsoft.Extensions.Hosting;
global using Microsoft.Extensions.Logging;
@@ -15,4 +14,5 @@ global using Spectre.Console;
global using Spectre.Console.Cli;
global using StreamShorts.Console.Commands;
-global using StreamShorts.Console.Hosting;
\ No newline at end of file
+global using StreamShorts.Console.Hosting;
+global using StreamShorts.Library.Media.Audio;
diff --git a/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs b/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs
new file mode 100644
index 0000000..c43563a
--- /dev/null
+++ b/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs
@@ -0,0 +1,63 @@
+using FFMpegCore;
+using FFMpegCore.Pipes;
+
+using Channel = FFMpegCore.Enums.Channel;
+
+namespace StreamShorts.Library.Media.Audio;
+
+/// ExtractMp3FromMp4Async(Stream video)
+ {
+ if (video is null)
+ {
+ throw new ArgumentNullException(nameof(video), "Video stream cannot be null");
+ }
+
+ if (video.CanRead is false)
+ {
+ throw new ArgumentException("Video stream must be readable", nameof(video));
+ }
+
+ if (video.CanSeek is false)
+ {
+ throw new ArgumentException("Video stream must be seekable", nameof(video));
+ }
+
+ var originalPosition = video.Position;
+
+ try
+ {
+ using var mp3Stream = new MemoryStream();
+ using var mp4Stream = new MemoryStream();
+
+ await video.CopyToAsync(mp4Stream).ConfigureAwait(false);
+ mp4Stream.Position = 0;
+
+ var wasExtracted = await FFMpegArguments
+ .FromPipeInput(new StreamPipeSource(mp4Stream))
+ .OutputToPipe(
+ new StreamPipeSink(mp3Stream),
+ o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
+ )
+ .ProcessAsynchronously()
+ .ConfigureAwait(false);
+
+ if (wasExtracted is false)
+ {
+ throw new FailedAudioExtractionException("Failed to extract audio from the video stream.");
+ }
+
+ return mp3Stream;
+ }
+ catch (Exception e) when (e is not FailedAudioExtractionException)
+ {
+ throw new FailedAudioExtractionException("Failed to extract audio", e);
+ }
+ finally
+ {
+ video.Position = originalPosition;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/Media/Audio/FailedAudioExtractionException.cs b/src/StreamShorts.Library/Media/Audio/FailedAudioExtractionException.cs
new file mode 100644
index 0000000..25e57ec
--- /dev/null
+++ b/src/StreamShorts.Library/Media/Audio/FailedAudioExtractionException.cs
@@ -0,0 +1,16 @@
+namespace StreamShorts.Library.Media.Audio;
+
+public class FailedAudioExtractionException : Exception
+{
+ public FailedAudioExtractionException() : base()
+ {
+ }
+
+ public FailedAudioExtractionException(string message) : base(message)
+ {
+ }
+
+ public FailedAudioExtractionException(string message, Exception innerException) : base(message, innerException)
+ {
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/Media/Audio/IAudioExtractor.cs b/src/StreamShorts.Library/Media/Audio/IAudioExtractor.cs
index e69de29..9996292 100644
--- a/src/StreamShorts.Library/Media/Audio/IAudioExtractor.cs
+++ b/src/StreamShorts.Library/Media/Audio/IAudioExtractor.cs
@@ -0,0 +1,19 @@
+namespace StreamShorts.Library.Media.Audio;
+
+///
+/// Represents an interface for extracting audio from video streams.
+///
+public interface IAudioExtractor
+{
+ ///
+ /// Extracts MP3 audio from an MP4 video stream.
+ ///
+ /// A stream containing the extracted MP3 audio.
+ /// Thrown when the video stream is null.
+ /// Thrown when the video stream is not readable.
+ /// Thrown when the video stream is not seekable.
+ /// Thrown when the audio extraction fails.
+ /// The method will preserve the passed video stream's data and position.
+ Task ExtractMp3FromMp4Async(Stream video);
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/StreamShorts.Library.csproj b/src/StreamShorts.Library/StreamShorts.Library.csproj
index c632161..7c67d16 100644
--- a/src/StreamShorts.Library/StreamShorts.Library.csproj
+++ b/src/StreamShorts.Library/StreamShorts.Library.csproj
@@ -1,3 +1,5 @@
-
+
+
diff --git a/tests/.editorconfig b/tests/.editorconfig
index 79bfd7f..b7ce383 100644
--- a/tests/.editorconfig
+++ b/tests/.editorconfig
@@ -1,2 +1,3 @@
[*.cs]
dotnet_diagnostic.CA1707.severity = none
+dotnet_diagnostic.CA2007.severity = none
diff --git a/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj b/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj
index 0dfcb36..68ccb7f 100644
--- a/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj
+++ b/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj
@@ -1,7 +1,9 @@
+
diff --git a/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs
new file mode 100644
index 0000000..7736e2b
--- /dev/null
+++ b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs
@@ -0,0 +1,36 @@
+namespace StreamShorts.Library.Tests.Unit.Media.Audio;
+
+public class AudioExtractorTests
+{
+ private readonly AudioExtractor _sut = new();
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenVideoIsNull_ItShouldThrow()
+ {
+ var action = async () => await _sut.ExtractMp3FromMp4Async(null!);
+
+ await action.Should().ThrowAsync();
+ }
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenVideoIsNotReadable_ItShouldThrow()
+ {
+ var mockStream = new Mock();
+ mockStream.Setup(s => s.CanRead).Returns(false);
+
+ var action = async () => await _sut.ExtractMp3FromMp4Async(mockStream.Object);
+
+ await action.Should().ThrowAsync();
+ }
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenVideoIsNotSeekable_ItShouldThrow()
+ {
+ var mockStream = new Mock();
+ mockStream.Setup(s => s.CanSeek).Returns(false);
+
+ var action = async () => await _sut.ExtractMp3FromMp4Async(mockStream.Object);
+
+ await action.Should().ThrowAsync();
+ }
+}
\ No newline at end of file
diff --git a/tests/StreamShorts.Library.Tests/Usings.cs b/tests/StreamShorts.Library.Tests/Usings.cs
new file mode 100644
index 0000000..0900feb
--- /dev/null
+++ b/tests/StreamShorts.Library.Tests/Usings.cs
@@ -0,0 +1,5 @@
+global using AwesomeAssertions;
+
+global using Moq;
+
+global using StreamShorts.Library.Media.Audio;
From 1765a730a71d63a2d6c108add3204c79c1f44fbd Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Sun, 27 Jul 2025 23:31:47 -0500
Subject: [PATCH 06/24] chore: whitelist a word
---
.vscode/settings.json | 1 +
1 file changed, 1 insertion(+)
diff --git a/.vscode/settings.json b/.vscode/settings.json
index 890c17d..30189f9 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,5 +1,6 @@
{
"cSpell.words": [
+ "resampler",
"resx"
]
}
\ No newline at end of file
From a53b3893ad33444fc9df6683411441e25707088e Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Sun, 27 Jul 2025 23:32:07 -0500
Subject: [PATCH 07/24] chore: update editorconfig preferences for tests
---
tests/.editorconfig | 1 +
1 file changed, 1 insertion(+)
diff --git a/tests/.editorconfig b/tests/.editorconfig
index b7ce383..83d34a6 100644
--- a/tests/.editorconfig
+++ b/tests/.editorconfig
@@ -1,3 +1,4 @@
[*.cs]
dotnet_diagnostic.CA1707.severity = none
dotnet_diagnostic.CA2007.severity = none
+dotnet_diagnostic.CA2201.severity = none
From a1864371dd98878492a45f52cf2f97cd33ca83a4 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Sun, 27 Jul 2025 23:33:05 -0500
Subject: [PATCH 08/24] feat: extract audio conversion to separate class and
refine audio extraction
---
.../Commands/DefaultCommand.cs | 21 +++-
src/StreamShorts.Console/Program.cs | 20 +---
.../Media/Audio/AudioConverter.cs | 18 ++++
.../Media/Audio/AudioExtractor.cs | 28 ++---
.../Media/Audio/IAudioConverter.cs | 6 ++
.../Media/FFMpegService.cs | 23 ++++
.../Media/IFFMpegService.cs | 6 ++
.../StreamShorts.Library.csproj | 1 +
.../Unit/Media/Audio/AudioConverterTests.cs | 10 ++
.../Unit/Media/Audio/AudioExtractorTests.cs | 101 +++++++++++++++++-
10 files changed, 199 insertions(+), 35 deletions(-)
create mode 100644 src/StreamShorts.Library/Media/Audio/AudioConverter.cs
create mode 100644 src/StreamShorts.Library/Media/Audio/IAudioConverter.cs
create mode 100644 src/StreamShorts.Library/Media/FFMpegService.cs
create mode 100644 src/StreamShorts.Library/Media/IFFMpegService.cs
create mode 100644 tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs
diff --git a/src/StreamShorts.Console/Commands/DefaultCommand.cs b/src/StreamShorts.Console/Commands/DefaultCommand.cs
index 152dc91..9fe3b9d 100644
--- a/src/StreamShorts.Console/Commands/DefaultCommand.cs
+++ b/src/StreamShorts.Console/Commands/DefaultCommand.cs
@@ -3,12 +3,14 @@ namespace StreamShorts.Console.Commands;
internal class DefaultCommand(
IFileSystem fileSystem,
IAnsiConsole console,
- IAudioExtractor audioExtractor
+ IAudioExtractor audioExtractor,
+ IAudioConverter audioConverter
) : AsyncCommand
{
private readonly IFileSystem _fileSystem = fileSystem ?? throw new ArgumentNullException(nameof(fileSystem));
private readonly IAnsiConsole _console = console ?? throw new ArgumentNullException(nameof(console));
private readonly IAudioExtractor _audioExtractor = audioExtractor ?? throw new ArgumentNullException(nameof(audioExtractor));
+ private readonly IAudioConverter _audioConverter = audioConverter ?? throw new ArgumentNullException(nameof(audioConverter));
internal class Settings : CommandSettings
{
@@ -61,6 +63,23 @@ internal class DefaultCommand(
_console.MarkupLine($"[blue]Audio extracted[/] [green]successfully![/]");
+ Stream? wavStream = null;
+
+ _console.Status()
+ .Spinner(Spinner.Known.Dots)
+ .Start("Converting audio...", ctx =>
+ {
+ wavStream = _audioConverter.ConvertMp3ToWav16(audioStream);
+ });
+
+ if (wavStream is null)
+ {
+ _console.MarkupLine("[red]Failed[/] to convert audio to WAV format.");
+ return 2;
+ }
+
+ _console.MarkupLine($"[blue]Audio converted[/] [green]successfully![/]");
+
return 0;
}
}
\ No newline at end of file
diff --git a/src/StreamShorts.Console/Program.cs b/src/StreamShorts.Console/Program.cs
index 8d518aa..1743853 100644
--- a/src/StreamShorts.Console/Program.cs
+++ b/src/StreamShorts.Console/Program.cs
@@ -37,6 +37,7 @@ try
services.AddSingleton(AnsiConsole.Console);
services.AddSingleton();
services.AddSingleton();
+ services.AddSingleton();
})
.BuildApp()
.RunAsync(args);
@@ -53,25 +54,6 @@ finally
await Log.CloseAndFlushAsync();
}
-// using var mp3Stream = new MemoryStream();
-// using var mp4Stream = new FileStream(args[0], FileMode.Open, FileAccess.Read);
-
-// var wasExtracted = await FFMpegArguments
-// .FromPipeInput(new StreamPipeSource(mp4Stream))
-// .OutputToPipe(
-// new StreamPipeSink(mp3Stream),
-// o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
-// )
-// .ProcessAsynchronously();
-
-// // Step 2: Convert MP3 stream to 16khz wave format
-// mp3Stream.Position = 0;
-// using var reader = new Mp3FileReader(mp3Stream);
-// var outFormat = new WaveFormat(16000, reader.WaveFormat.Channels);
-// using var resampler = new MediaFoundationResampler(reader, outFormat);
-// using var waveStream = new MemoryStream();
-// WaveFileWriter.WriteWavFileToStream(waveStream, resampler);
-
// // Step 3: Split the wave stream into 2 minute segments
// waveStream.Position = 0;
// var segmentDuration = TimeSpan.FromMinutes(2);
diff --git a/src/StreamShorts.Library/Media/Audio/AudioConverter.cs b/src/StreamShorts.Library/Media/Audio/AudioConverter.cs
new file mode 100644
index 0000000..b90245e
--- /dev/null
+++ b/src/StreamShorts.Library/Media/Audio/AudioConverter.cs
@@ -0,0 +1,18 @@
+
+using NAudio.Wave;
+
+namespace StreamShorts.Library.Media.Audio;
+
+public class AudioConverter : IAudioConverter
+{
+ public Stream ConvertMp3ToWav16(Stream mp3)
+ {
+ using var reader = new Mp3FileReader(mp3);
+ var outFormat = new WaveFormat(16000, reader.WaveFormat.Channels);
+ using var resampler = new MediaFoundationResampler(reader, outFormat);
+ var waveStream = new MemoryStream();
+ WaveFileWriter.WriteWavFileToStream(waveStream, resampler);
+ waveStream.Position = 0;
+ return waveStream;
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs b/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs
index c43563a..a78b13d 100644
--- a/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs
+++ b/src/StreamShorts.Library/Media/Audio/AudioExtractor.cs
@@ -1,13 +1,19 @@
-using FFMpegCore;
-using FFMpegCore.Pipes;
-
-using Channel = FFMpegCore.Enums.Channel;
-
namespace StreamShorts.Library.Media.Audio;
/// ExtractMp3FromMp4Async(Stream video)
{
if (video is null)
@@ -29,26 +35,20 @@ public class AudioExtractor : IAudioExtractor
try
{
- using var mp3Stream = new MemoryStream();
+ var mp3Stream = new MemoryStream();
using var mp4Stream = new MemoryStream();
await video.CopyToAsync(mp4Stream).ConfigureAwait(false);
mp4Stream.Position = 0;
- var wasExtracted = await FFMpegArguments
- .FromPipeInput(new StreamPipeSource(mp4Stream))
- .OutputToPipe(
- new StreamPipeSink(mp3Stream),
- o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
- )
- .ProcessAsynchronously()
- .ConfigureAwait(false);
+ var wasExtracted = await _ffmpegService.ExtractAudioFromVideoAsync(mp4Stream, mp3Stream).ConfigureAwait(false);
if (wasExtracted is false)
{
throw new FailedAudioExtractionException("Failed to extract audio from the video stream.");
}
+ mp3Stream.Position = 0;
return mp3Stream;
}
catch (Exception e) when (e is not FailedAudioExtractionException)
diff --git a/src/StreamShorts.Library/Media/Audio/IAudioConverter.cs b/src/StreamShorts.Library/Media/Audio/IAudioConverter.cs
new file mode 100644
index 0000000..2022b31
--- /dev/null
+++ b/src/StreamShorts.Library/Media/Audio/IAudioConverter.cs
@@ -0,0 +1,6 @@
+namespace StreamShorts.Library.Media.Audio;
+
+public interface IAudioConverter
+{
+ Stream ConvertMp3ToWav16(Stream mp3);
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/Media/FFMpegService.cs b/src/StreamShorts.Library/Media/FFMpegService.cs
new file mode 100644
index 0000000..509de62
--- /dev/null
+++ b/src/StreamShorts.Library/Media/FFMpegService.cs
@@ -0,0 +1,23 @@
+using System.Diagnostics.CodeAnalysis;
+
+using FFMpegCore;
+using FFMpegCore.Enums;
+using FFMpegCore.Pipes;
+
+namespace StreamShorts.Library.Media;
+
+[ExcludeFromCodeCoverage]
+internal class FFMpegService : IFFMpegService
+{
+ public async Task ExtractAudioFromVideoAsync(Stream video, Stream audio)
+ {
+ return await FFMpegArguments
+ .FromPipeInput(new StreamPipeSource(video))
+ .OutputToPipe(
+ new StreamPipeSink(audio),
+ static o => o.DisableChannel(Channel.Video).ForceFormat("mp3")
+ )
+ .ProcessAsynchronously()
+ .ConfigureAwait(false);
+ }
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/Media/IFFMpegService.cs b/src/StreamShorts.Library/Media/IFFMpegService.cs
new file mode 100644
index 0000000..50e10c8
--- /dev/null
+++ b/src/StreamShorts.Library/Media/IFFMpegService.cs
@@ -0,0 +1,6 @@
+namespace StreamShorts.Library.Media;
+
+internal interface IFFMpegService
+{
+ Task ExtractAudioFromVideoAsync(Stream video, Stream audio);
+}
\ No newline at end of file
diff --git a/src/StreamShorts.Library/StreamShorts.Library.csproj b/src/StreamShorts.Library/StreamShorts.Library.csproj
index 7c67d16..281f941 100644
--- a/src/StreamShorts.Library/StreamShorts.Library.csproj
+++ b/src/StreamShorts.Library/StreamShorts.Library.csproj
@@ -1,5 +1,6 @@
diff --git a/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs
new file mode 100644
index 0000000..a5dcf03
--- /dev/null
+++ b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs
@@ -0,0 +1,10 @@
+namespace StreamShorts.Library.Tests.Unit.Media.Audio;
+
+public class AudioConverterTests
+{
+ [Fact]
+ public void Test()
+ {
+ throw new NotImplementedException();
+ }
+}
\ No newline at end of file
diff --git a/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs
index 7736e2b..4f0707f 100644
--- a/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs
+++ b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioExtractorTests.cs
@@ -1,8 +1,18 @@
+using System.Text;
+
+using StreamShorts.Library.Media;
+
namespace StreamShorts.Library.Tests.Unit.Media.Audio;
public class AudioExtractorTests
{
- private readonly AudioExtractor _sut = new();
+ private readonly Mock _mockFfmpegService = new();
+ private readonly AudioExtractor _sut;
+
+ public AudioExtractorTests()
+ {
+ _sut = new(_mockFfmpegService.Object);
+ }
[Fact]
public async Task ExtractMp3FromMp4Async_WhenVideoIsNull_ItShouldThrow()
@@ -33,4 +43,93 @@ public class AudioExtractorTests
await action.Should().ThrowAsync();
}
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenFFMpegServiceThrows_ItShouldThrow()
+ {
+ var mockStream = new Mock();
+ mockStream.Setup(static s => s.CanRead).Returns(true);
+ mockStream.Setup(static s => s.CanSeek).Returns(true);
+
+ _mockFfmpegService.
+ Setup(
+ static m => m.ExtractAudioFromVideoAsync(
+ It.IsAny(),
+ It.IsAny()
+ )
+ )
+ .ThrowsAsync(new Exception());
+
+ var action = async () => await _sut.ExtractMp3FromMp4Async(mockStream.Object);
+
+ await action.Should().ThrowAsync();
+ }
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenFFMpegServiceFailsExtraction_ItShouldThrow()
+ {
+ var mockStream = new Mock();
+ mockStream.Setup(static s => s.CanRead).Returns(true);
+ mockStream.Setup(static s => s.CanSeek).Returns(true);
+
+ _mockFfmpegService.
+ Setup(
+ static m => m.ExtractAudioFromVideoAsync(
+ It.IsAny(),
+ It.IsAny()
+ )
+ )
+ .ReturnsAsync(false);
+
+ var action = async () => await _sut.ExtractMp3FromMp4Async(mockStream.Object);
+
+ await action.Should().ThrowAsync();
+ }
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenFFMpegServiceSucceedsAtExtractingAudio_ItShouldReturnStream()
+ {
+ var mockStream = new Mock();
+ mockStream.Setup(static s => s.CanRead).Returns(true);
+ mockStream.Setup(static s => s.CanSeek).Returns(true);
+
+ _mockFfmpegService.
+ Setup(
+ static m => m.ExtractAudioFromVideoAsync(
+ It.IsAny(),
+ It.IsAny()
+ )
+ )
+ .ReturnsAsync(true);
+
+ var result = await _sut.ExtractMp3FromMp4Async(mockStream.Object);
+
+ result.Should().BeAssignableTo();
+ result.Should().BeOfType();
+ }
+
+ [Fact]
+ public async Task ExtractMp3FromMp4Async_WhenCalled_ItShouldNotMutatePositionOfPassedStream()
+ {
+ var text = "hello world";
+ var textByte = Encoding.UTF8.GetBytes(text);
+ var stream = new MemoryStream(textByte);
+
+ var positionToRead = 5;
+ var buffer = new byte[5];
+ await stream.ReadAsync(buffer.AsMemory(0, positionToRead), TestContext.Current.CancellationToken);
+
+ _mockFfmpegService.
+ Setup(
+ static m => m.ExtractAudioFromVideoAsync(
+ It.IsAny(),
+ It.IsAny()
+ )
+ )
+ .ReturnsAsync(true);
+
+ await _sut.ExtractMp3FromMp4Async(stream);
+
+ stream.Position.Should().Be(positionToRead);
+ }
}
\ No newline at end of file
From 76667f01d6742951e5a9062952656324cb3f5cbc Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Sun, 27 Jul 2025 23:33:16 -0500
Subject: [PATCH 09/24] chore: delete unused template file
---
src/StreamShorts.Library/Class1.cs | 6 ------
1 file changed, 6 deletions(-)
delete mode 100644 src/StreamShorts.Library/Class1.cs
diff --git a/src/StreamShorts.Library/Class1.cs b/src/StreamShorts.Library/Class1.cs
deleted file mode 100644
index f6e19c1..0000000
--- a/src/StreamShorts.Library/Class1.cs
+++ /dev/null
@@ -1,6 +0,0 @@
-namespace StreamShorts.Library;
-
-public class Class1
-{
-
-}
From d5f1347587501dd9c1f8f320a9f1dc295ac05d3c Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Sun, 27 Jul 2025 23:33:45 -0500
Subject: [PATCH 10/24] feat: wip on extracting whisper transcription logic to
separate class
---
.../Transcription/ITranscriber.cs | 12 ++++++++++++
.../Transcription/WhisperTranscriber.cs | 10 ++++++++++
2 files changed, 22 insertions(+)
create mode 100644 src/StreamShorts.Library/Transcription/ITranscriber.cs
create mode 100644 src/StreamShorts.Library/Transcription/WhisperTranscriber.cs
diff --git a/src/StreamShorts.Library/Transcription/ITranscriber.cs b/src/StreamShorts.Library/Transcription/ITranscriber.cs
new file mode 100644
index 0000000..425da8d
--- /dev/null
+++ b/src/StreamShorts.Library/Transcription/ITranscriber.cs
@@ -0,0 +1,12 @@
+namespace StreamShorts.Library.Transcription;
+
+public interface ITranscriber
+{
+ IAsyncEnumerable TranscribeAsync(Stream audio);
+}
+
+public record TranscriptionSegment(
+ TimeSpan StartTime,
+ TimeSpan EndTime,
+ string Text
+);
\ No newline at end of file
diff --git a/src/StreamShorts.Library/Transcription/WhisperTranscriber.cs b/src/StreamShorts.Library/Transcription/WhisperTranscriber.cs
new file mode 100644
index 0000000..c77a20a
--- /dev/null
+++ b/src/StreamShorts.Library/Transcription/WhisperTranscriber.cs
@@ -0,0 +1,10 @@
+
+namespace StreamShorts.Library.Transcription;
+
+public class WhisperTranscriber : ITranscriber
+{
+ public IAsyncEnumerable TranscribeAsync(Stream audio)
+ {
+ throw new NotImplementedException();
+ }
+}
\ No newline at end of file
From 30f2032cef8f229fc5071dbfc121fd7fffbb1cc9 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Mon, 28 Jul 2025 17:26:54 -0500
Subject: [PATCH 11/24] tests: setup test coverage
---
tests/Directory.Packages.props | 1 +
.../StreamShorts.Console.Tests.csproj | 5 +++++
.../StreamShorts.Library.Tests.csproj | 5 +++++
.../Unit/Media/Audio/AudioConverterTests.cs | 2 +-
tests/StreamShorts.Library.Tests/UnitTest1.cs | 10 ----------
5 files changed, 12 insertions(+), 11 deletions(-)
delete mode 100644 tests/StreamShorts.Library.Tests/UnitTest1.cs
diff --git a/tests/Directory.Packages.props b/tests/Directory.Packages.props
index cfd8c30..565f5b3 100644
--- a/tests/Directory.Packages.props
+++ b/tests/Directory.Packages.props
@@ -5,6 +5,7 @@
+
+
+
diff --git a/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj b/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj
index 68ccb7f..39d9852 100644
--- a/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj
+++ b/tests/StreamShorts.Library.Tests/StreamShorts.Library.Tests.csproj
@@ -3,11 +3,16 @@
+
+
+
diff --git a/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs
index a5dcf03..886d185 100644
--- a/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs
+++ b/tests/StreamShorts.Library.Tests/Unit/Media/Audio/AudioConverterTests.cs
@@ -5,6 +5,6 @@ public class AudioConverterTests
[Fact]
public void Test()
{
- throw new NotImplementedException();
+ return;
}
}
\ No newline at end of file
diff --git a/tests/StreamShorts.Library.Tests/UnitTest1.cs b/tests/StreamShorts.Library.Tests/UnitTest1.cs
deleted file mode 100644
index 7cf24e6..0000000
--- a/tests/StreamShorts.Library.Tests/UnitTest1.cs
+++ /dev/null
@@ -1,10 +0,0 @@
-namespace StreamShorts.Library.Tests;
-
-public class UnitTest1
-{
- [Fact]
- public void Test1()
- {
- Assert.True(true);
- }
-}
From 5ee040f2d005001d296b89a14a3969e06069038a Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Mon, 28 Jul 2025 17:59:27 -0500
Subject: [PATCH 12/24] tests: add integration test for audio extractor
---
.../Data/Files/extracted_audio.mp3 | Bin 0 -> 615800 bytes
.../Data/Files/video.mp4 | Bin 0 -> 10246386 bytes
.../Data/TestData.cs | 24 ++++++++++++++++
.../Media/Audio/AudioExtractorTests.cs | 27 ++++++++++++++++++
.../StreamShorts.Library.Tests.csproj | 6 ++++
.../Unit/Media/Audio/AudioExtractorTests.cs | 1 +
tests/StreamShorts.Library.Tests/Usings.cs | 1 +
7 files changed, 59 insertions(+)
create mode 100644 tests/StreamShorts.Library.Tests/Data/Files/extracted_audio.mp3
create mode 100644 tests/StreamShorts.Library.Tests/Data/Files/video.mp4
create mode 100644 tests/StreamShorts.Library.Tests/Data/TestData.cs
create mode 100644 tests/StreamShorts.Library.Tests/Integration/Media/Audio/AudioExtractorTests.cs
diff --git a/tests/StreamShorts.Library.Tests/Data/Files/extracted_audio.mp3 b/tests/StreamShorts.Library.Tests/Data/Files/extracted_audio.mp3
new file mode 100644
index 0000000000000000000000000000000000000000..5c753157019c02ccfea6dc5c0b842cd81fe20c19
GIT binary patch
literal 615800
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