< Summary - Jellyfin

Information
Class: Jellyfin.Api.Controllers.AudioController
Assembly: Jellyfin.Api
File(s): /srv/git/jellyfin/Jellyfin.Api/Controllers/AudioController.cs
Line coverage
0%
Covered lines: 0
Uncovered lines: 109
Coverable lines: 109
Total lines: 361
Line coverage: 0%
Branch coverage
N/A
Covered branches: 0
Total branches: 0
Branch coverage: N/A
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Coverage history

Coverage history 0 25 50 75 100 1/23/2026 - 12:11:06 AM Line coverage: 0% (0/3) Total lines: 3614/19/2026 - 12:14:27 AM Line coverage: 0% (0/109) Total lines: 361

Coverage delta

Coverage delta 1 -1

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
.ctor(...)100%210%
GetAudioStream()100%210%
GetAudioStreamByContainer()100%210%

File(s)

/srv/git/jellyfin/Jellyfin.Api/Controllers/AudioController.cs

#LineLine coverage
 1using System;
 2using System.Collections.Generic;
 3using System.ComponentModel.DataAnnotations;
 4using System.Threading.Tasks;
 5using Jellyfin.Api.Attributes;
 6using Jellyfin.Api.Helpers;
 7using Jellyfin.Api.Models.StreamingDtos;
 8using MediaBrowser.Controller.MediaEncoding;
 9using MediaBrowser.Controller.Streaming;
 10using MediaBrowser.Model.Dlna;
 11using Microsoft.AspNetCore.Http;
 12using Microsoft.AspNetCore.Mvc;
 13
 14namespace Jellyfin.Api.Controllers;
 15
 16/// <summary>
 17/// The audio controller.
 18/// </summary>
 19public class AudioController : BaseJellyfinApiController
 20{
 21    private readonly AudioHelper _audioHelper;
 22
 23    private readonly TranscodingJobType _transcodingJobType = TranscodingJobType.Progressive;
 24
 25    /// <summary>
 26    /// Initializes a new instance of the <see cref="AudioController"/> class.
 27    /// </summary>
 28    /// <param name="audioHelper">Instance of <see cref="AudioHelper"/>.</param>
 029    public AudioController(AudioHelper audioHelper)
 30    {
 031        _audioHelper = audioHelper;
 032    }
 33
 34    /// <summary>
 35    /// Gets an audio stream.
 36    /// </summary>
 37    /// <param name="itemId">The item id.</param>
 38    /// <param name="container">The audio container.</param>
 39    /// <param name="static">Optional. If true, the original file will be streamed statically without any encoding. Use 
 40    /// <param name="params">The streaming parameters.</param>
 41    /// <param name="tag">The tag.</param>
 42    /// <param name="deviceProfileId">Optional. The dlna device profile id to utilize.</param>
 43    /// <param name="playSessionId">The play session id.</param>
 44    /// <param name="segmentContainer">The segment container.</param>
 45    /// <param name="segmentLength">The segment length.</param>
 46    /// <param name="minSegments">The minimum number of segments.</param>
 47    /// <param name="mediaSourceId">The media version id, if playing an alternate version.</param>
 48    /// <param name="deviceId">The device id of the client requesting. Used to stop encoding processes when needed.</par
 49    /// <param name="audioCodec">Optional. Specify an audio codec to encode to, e.g. mp3. If omitted the server will aut
 50    /// <param name="enableAutoStreamCopy">Whether or not to allow automatic stream copy if requested values match the o
 51    /// <param name="allowVideoStreamCopy">Whether or not to allow copying of the video stream url.</param>
 52    /// <param name="allowAudioStreamCopy">Whether or not to allow copying of the audio stream url.</param>
 53    /// <param name="audioSampleRate">Optional. Specify a specific audio sample rate, e.g. 44100.</param>
 54    /// <param name="maxAudioBitDepth">Optional. The maximum audio bit depth.</param>
 55    /// <param name="audioBitRate">Optional. Specify an audio bitrate to encode to, e.g. 128000. If omitted this will be
 56    /// <param name="audioChannels">Optional. Specify a specific number of audio channels to encode to, e.g. 2.</param>
 57    /// <param name="maxAudioChannels">Optional. Specify a maximum number of audio channels to encode to, e.g. 2.</param
 58    /// <param name="profile">Optional. Specify a specific an encoder profile (varies by encoder), e.g. main, baseline, 
 59    /// <param name="level">Optional. Specify a level for the encoder profile (varies by encoder), e.g. 3, 3.1.</param>
 60    /// <param name="framerate">Optional. A specific video framerate to encode to, e.g. 23.976. Generally this should be
 61    /// <param name="maxFramerate">Optional. A specific maximum video framerate to encode to, e.g. 23.976. Generally thi
 62    /// <param name="copyTimestamps">Whether or not to copy timestamps when transcoding with an offset. Defaults to fals
 63    /// <param name="startTimeTicks">Optional. Specify a starting offset, in ticks. 1 tick = 10000 ms.</param>
 64    /// <param name="width">Optional. The fixed horizontal resolution of the encoded video.</param>
 65    /// <param name="height">Optional. The fixed vertical resolution of the encoded video.</param>
 66    /// <param name="videoBitRate">Optional. Specify a video bitrate to encode to, e.g. 500000. If omitted this will be 
 67    /// <param name="subtitleStreamIndex">Optional. The index of the subtitle stream to use. If omitted no subtitles wil
 68    /// <param name="subtitleMethod">Optional. Specify the subtitle delivery method.</param>
 69    /// <param name="maxRefFrames">Optional.</param>
 70    /// <param name="maxVideoBitDepth">Optional. The maximum video bit depth.</param>
 71    /// <param name="requireAvc">Optional. Whether to require avc.</param>
 72    /// <param name="deInterlace">Optional. Whether to deinterlace the video.</param>
 73    /// <param name="requireNonAnamorphic">Optional. Whether to require a non anamorphic stream.</param>
 74    /// <param name="transcodingMaxAudioChannels">Optional. The maximum number of audio channels to transcode.</param>
 75    /// <param name="cpuCoreLimit">Optional. The limit of how many cpu cores to use.</param>
 76    /// <param name="liveStreamId">The live stream id.</param>
 77    /// <param name="enableMpegtsM2TsMode">Optional. Whether to enable the MpegtsM2Ts mode.</param>
 78    /// <param name="videoCodec">Optional. Specify a video codec to encode to, e.g. h264. If omitted the server will aut
 79    /// <param name="subtitleCodec">Optional. Specify a subtitle codec to encode to.</param>
 80    /// <param name="transcodeReasons">Optional. The transcoding reason.</param>
 81    /// <param name="audioStreamIndex">Optional. The index of the audio stream to use. If omitted the first audio stream
 82    /// <param name="videoStreamIndex">Optional. The index of the video stream to use. If omitted the first video stream
 83    /// <param name="context">Optional. The <see cref="EncodingContext"/>.</param>
 84    /// <param name="streamOptions">Optional. The streaming options.</param>
 85    /// <param name="enableAudioVbrEncoding">Optional. Whether to enable Audio Encoding.</param>
 86    /// <response code="200">Audio stream returned.</response>
 87    /// <returns>A <see cref="FileResult"/> containing the audio file.</returns>
 88    [HttpGet("{itemId}/stream", Name = "GetAudioStream")]
 89    [HttpHead("{itemId}/stream", Name = "HeadAudioStream")]
 90    [ProducesResponseType(StatusCodes.Status200OK)]
 91    [ProducesAudioFile]
 92    public async Task<ActionResult> GetAudioStream(
 93        [FromRoute, Required] Guid itemId,
 94        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? container,
 95        [FromQuery] bool? @static,
 96        [FromQuery] string? @params,
 97        [FromQuery] string? tag,
 98        [FromQuery, ParameterObsolete] string? deviceProfileId,
 99        [FromQuery] string? playSessionId,
 100        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? segmentContainer,
 101        [FromQuery] int? segmentLength,
 102        [FromQuery] int? minSegments,
 103        [FromQuery] string? mediaSourceId,
 104        [FromQuery] string? deviceId,
 105        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? audioCodec,
 106        [FromQuery] bool? enableAutoStreamCopy,
 107        [FromQuery] bool? allowVideoStreamCopy,
 108        [FromQuery] bool? allowAudioStreamCopy,
 109        [FromQuery] int? audioSampleRate,
 110        [FromQuery] int? maxAudioBitDepth,
 111        [FromQuery] int? audioBitRate,
 112        [FromQuery] int? audioChannels,
 113        [FromQuery] int? maxAudioChannels,
 114        [FromQuery] string? profile,
 115        [FromQuery] [RegularExpression(EncodingHelper.LevelValidationRegexStr)] string? level,
 116        [FromQuery] float? framerate,
 117        [FromQuery] float? maxFramerate,
 118        [FromQuery] bool? copyTimestamps,
 119        [FromQuery] long? startTimeTicks,
 120        [FromQuery] int? width,
 121        [FromQuery] int? height,
 122        [FromQuery] int? videoBitRate,
 123        [FromQuery] int? subtitleStreamIndex,
 124        [FromQuery] SubtitleDeliveryMethod? subtitleMethod,
 125        [FromQuery] int? maxRefFrames,
 126        [FromQuery] int? maxVideoBitDepth,
 127        [FromQuery] bool? requireAvc,
 128        [FromQuery] bool? deInterlace,
 129        [FromQuery] bool? requireNonAnamorphic,
 130        [FromQuery] int? transcodingMaxAudioChannels,
 131        [FromQuery] int? cpuCoreLimit,
 132        [FromQuery] string? liveStreamId,
 133        [FromQuery] bool? enableMpegtsM2TsMode,
 134        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? videoCodec,
 135        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? subtitleCodec,
 136        [FromQuery] string? transcodeReasons,
 137        [FromQuery] int? audioStreamIndex,
 138        [FromQuery] int? videoStreamIndex,
 139        [FromQuery] EncodingContext? context,
 140        [FromQuery] Dictionary<string, string>? streamOptions,
 141        [FromQuery] bool enableAudioVbrEncoding = true)
 142    {
 0143        StreamingRequestDto streamingRequest = new StreamingRequestDto
 0144        {
 0145            Id = itemId,
 0146            Container = container,
 0147            Static = @static ?? false,
 0148            Params = @params,
 0149            Tag = tag,
 0150            PlaySessionId = playSessionId,
 0151            SegmentContainer = segmentContainer,
 0152            SegmentLength = segmentLength,
 0153            MinSegments = minSegments,
 0154            MediaSourceId = mediaSourceId,
 0155            DeviceId = deviceId,
 0156            AudioCodec = audioCodec,
 0157            EnableAutoStreamCopy = enableAutoStreamCopy ?? true,
 0158            AllowAudioStreamCopy = allowAudioStreamCopy ?? true,
 0159            AllowVideoStreamCopy = allowVideoStreamCopy ?? true,
 0160            AudioSampleRate = audioSampleRate,
 0161            MaxAudioChannels = maxAudioChannels,
 0162            AudioBitRate = audioBitRate,
 0163            MaxAudioBitDepth = maxAudioBitDepth,
 0164            AudioChannels = audioChannels,
 0165            Profile = profile,
 0166            Level = level,
 0167            Framerate = framerate,
 0168            MaxFramerate = maxFramerate,
 0169            CopyTimestamps = copyTimestamps ?? false,
 0170            StartTimeTicks = startTimeTicks,
 0171            Width = width,
 0172            Height = height,
 0173            VideoBitRate = videoBitRate,
 0174            SubtitleStreamIndex = subtitleStreamIndex,
 0175            SubtitleMethod = subtitleMethod ?? SubtitleDeliveryMethod.Encode,
 0176            MaxRefFrames = maxRefFrames,
 0177            MaxVideoBitDepth = maxVideoBitDepth,
 0178            RequireAvc = requireAvc ?? false,
 0179            DeInterlace = deInterlace ?? false,
 0180            RequireNonAnamorphic = requireNonAnamorphic ?? false,
 0181            TranscodingMaxAudioChannels = transcodingMaxAudioChannels,
 0182            CpuCoreLimit = cpuCoreLimit,
 0183            LiveStreamId = liveStreamId,
 0184            EnableMpegtsM2TsMode = enableMpegtsM2TsMode ?? false,
 0185            VideoCodec = videoCodec,
 0186            SubtitleCodec = subtitleCodec,
 0187            TranscodeReasons = transcodeReasons,
 0188            AudioStreamIndex = audioStreamIndex,
 0189            VideoStreamIndex = videoStreamIndex,
 0190            Context = context ?? EncodingContext.Static,
 0191            StreamOptions = streamOptions,
 0192            EnableAudioVbrEncoding = enableAudioVbrEncoding
 0193        };
 194
 0195        return await _audioHelper.GetAudioStream(_transcodingJobType, streamingRequest).ConfigureAwait(false);
 0196    }
 197
 198    /// <summary>
 199    /// Gets an audio stream.
 200    /// </summary>
 201    /// <param name="itemId">The item id.</param>
 202    /// <param name="container">The audio container.</param>
 203    /// <param name="static">Optional. If true, the original file will be streamed statically without any encoding. Use 
 204    /// <param name="params">The streaming parameters.</param>
 205    /// <param name="tag">The tag.</param>
 206    /// <param name="deviceProfileId">Optional. The dlna device profile id to utilize.</param>
 207    /// <param name="playSessionId">The play session id.</param>
 208    /// <param name="segmentContainer">The segment container.</param>
 209    /// <param name="segmentLength">The segment length.</param>
 210    /// <param name="minSegments">The minimum number of segments.</param>
 211    /// <param name="mediaSourceId">The media version id, if playing an alternate version.</param>
 212    /// <param name="deviceId">The device id of the client requesting. Used to stop encoding processes when needed.</par
 213    /// <param name="audioCodec">Optional. Specify an audio codec to encode to, e.g. mp3. If omitted the server will aut
 214    /// <param name="enableAutoStreamCopy">Whether or not to allow automatic stream copy if requested values match the o
 215    /// <param name="allowVideoStreamCopy">Whether or not to allow copying of the video stream url.</param>
 216    /// <param name="allowAudioStreamCopy">Whether or not to allow copying of the audio stream url.</param>
 217    /// <param name="audioSampleRate">Optional. Specify a specific audio sample rate, e.g. 44100.</param>
 218    /// <param name="maxAudioBitDepth">Optional. The maximum audio bit depth.</param>
 219    /// <param name="audioBitRate">Optional. Specify an audio bitrate to encode to, e.g. 128000. If omitted this will be
 220    /// <param name="audioChannels">Optional. Specify a specific number of audio channels to encode to, e.g. 2.</param>
 221    /// <param name="maxAudioChannels">Optional. Specify a maximum number of audio channels to encode to, e.g. 2.</param
 222    /// <param name="profile">Optional. Specify a specific an encoder profile (varies by encoder), e.g. main, baseline, 
 223    /// <param name="level">Optional. Specify a level for the encoder profile (varies by encoder), e.g. 3, 3.1.</param>
 224    /// <param name="framerate">Optional. A specific video framerate to encode to, e.g. 23.976. Generally this should be
 225    /// <param name="maxFramerate">Optional. A specific maximum video framerate to encode to, e.g. 23.976. Generally thi
 226    /// <param name="copyTimestamps">Whether or not to copy timestamps when transcoding with an offset. Defaults to fals
 227    /// <param name="startTimeTicks">Optional. Specify a starting offset, in ticks. 1 tick = 10000 ms.</param>
 228    /// <param name="width">Optional. The fixed horizontal resolution of the encoded video.</param>
 229    /// <param name="height">Optional. The fixed vertical resolution of the encoded video.</param>
 230    /// <param name="videoBitRate">Optional. Specify a video bitrate to encode to, e.g. 500000. If omitted this will be 
 231    /// <param name="subtitleStreamIndex">Optional. The index of the subtitle stream to use. If omitted no subtitles wil
 232    /// <param name="subtitleMethod">Optional. Specify the subtitle delivery method.</param>
 233    /// <param name="maxRefFrames">Optional.</param>
 234    /// <param name="maxVideoBitDepth">Optional. The maximum video bit depth.</param>
 235    /// <param name="requireAvc">Optional. Whether to require avc.</param>
 236    /// <param name="deInterlace">Optional. Whether to deinterlace the video.</param>
 237    /// <param name="requireNonAnamorphic">Optional. Whether to require a non anamorphic stream.</param>
 238    /// <param name="transcodingMaxAudioChannels">Optional. The maximum number of audio channels to transcode.</param>
 239    /// <param name="cpuCoreLimit">Optional. The limit of how many cpu cores to use.</param>
 240    /// <param name="liveStreamId">The live stream id.</param>
 241    /// <param name="enableMpegtsM2TsMode">Optional. Whether to enable the MpegtsM2Ts mode.</param>
 242    /// <param name="videoCodec">Optional. Specify a video codec to encode to, e.g. h264. If omitted the server will aut
 243    /// <param name="subtitleCodec">Optional. Specify a subtitle codec to encode to.</param>
 244    /// <param name="transcodeReasons">Optional. The transcoding reason.</param>
 245    /// <param name="audioStreamIndex">Optional. The index of the audio stream to use. If omitted the first audio stream
 246    /// <param name="videoStreamIndex">Optional. The index of the video stream to use. If omitted the first video stream
 247    /// <param name="context">Optional. The <see cref="EncodingContext"/>.</param>
 248    /// <param name="streamOptions">Optional. The streaming options.</param>
 249    /// <param name="enableAudioVbrEncoding">Optional. Whether to enable Audio Encoding.</param>
 250    /// <response code="200">Audio stream returned.</response>
 251    /// <returns>A <see cref="FileResult"/> containing the audio file.</returns>
 252    [HttpGet("{itemId}/stream.{container}", Name = "GetAudioStreamByContainer")]
 253    [HttpHead("{itemId}/stream.{container}", Name = "HeadAudioStreamByContainer")]
 254    [ProducesResponseType(StatusCodes.Status200OK)]
 255    [ProducesAudioFile]
 256    public async Task<ActionResult> GetAudioStreamByContainer(
 257        [FromRoute, Required] Guid itemId,
 258        [FromRoute, Required] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string container,
 259        [FromQuery] bool? @static,
 260        [FromQuery] string? @params,
 261        [FromQuery] string? tag,
 262        [FromQuery, ParameterObsolete] string? deviceProfileId,
 263        [FromQuery] string? playSessionId,
 264        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? segmentContainer,
 265        [FromQuery] int? segmentLength,
 266        [FromQuery] int? minSegments,
 267        [FromQuery] string? mediaSourceId,
 268        [FromQuery] string? deviceId,
 269        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? audioCodec,
 270        [FromQuery] bool? enableAutoStreamCopy,
 271        [FromQuery] bool? allowVideoStreamCopy,
 272        [FromQuery] bool? allowAudioStreamCopy,
 273        [FromQuery] int? audioSampleRate,
 274        [FromQuery] int? maxAudioBitDepth,
 275        [FromQuery] int? audioBitRate,
 276        [FromQuery] int? audioChannels,
 277        [FromQuery] int? maxAudioChannels,
 278        [FromQuery] string? profile,
 279        [FromQuery] [RegularExpression(EncodingHelper.LevelValidationRegexStr)] string? level,
 280        [FromQuery] float? framerate,
 281        [FromQuery] float? maxFramerate,
 282        [FromQuery] bool? copyTimestamps,
 283        [FromQuery] long? startTimeTicks,
 284        [FromQuery] int? width,
 285        [FromQuery] int? height,
 286        [FromQuery] int? videoBitRate,
 287        [FromQuery] int? subtitleStreamIndex,
 288        [FromQuery] SubtitleDeliveryMethod? subtitleMethod,
 289        [FromQuery] int? maxRefFrames,
 290        [FromQuery] int? maxVideoBitDepth,
 291        [FromQuery] bool? requireAvc,
 292        [FromQuery] bool? deInterlace,
 293        [FromQuery] bool? requireNonAnamorphic,
 294        [FromQuery] int? transcodingMaxAudioChannels,
 295        [FromQuery] int? cpuCoreLimit,
 296        [FromQuery] string? liveStreamId,
 297        [FromQuery] bool? enableMpegtsM2TsMode,
 298        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? videoCodec,
 299        [FromQuery] [RegularExpression(EncodingHelper.ContainerValidationRegexStr)] string? subtitleCodec,
 300        [FromQuery] string? transcodeReasons,
 301        [FromQuery] int? audioStreamIndex,
 302        [FromQuery] int? videoStreamIndex,
 303        [FromQuery] EncodingContext? context,
 304        [FromQuery] Dictionary<string, string>? streamOptions,
 305        [FromQuery] bool enableAudioVbrEncoding = true)
 306    {
 0307        StreamingRequestDto streamingRequest = new StreamingRequestDto
 0308        {
 0309            Id = itemId,
 0310            Container = container,
 0311            Static = @static ?? false,
 0312            Params = @params,
 0313            Tag = tag,
 0314            PlaySessionId = playSessionId,
 0315            SegmentContainer = segmentContainer,
 0316            SegmentLength = segmentLength,
 0317            MinSegments = minSegments,
 0318            MediaSourceId = mediaSourceId,
 0319            DeviceId = deviceId,
 0320            AudioCodec = audioCodec,
 0321            EnableAutoStreamCopy = enableAutoStreamCopy ?? true,
 0322            AllowAudioStreamCopy = allowAudioStreamCopy ?? true,
 0323            AllowVideoStreamCopy = allowVideoStreamCopy ?? true,
 0324            AudioSampleRate = audioSampleRate,
 0325            MaxAudioChannels = maxAudioChannels,
 0326            AudioBitRate = audioBitRate,
 0327            MaxAudioBitDepth = maxAudioBitDepth,
 0328            AudioChannels = audioChannels,
 0329            Profile = profile,
 0330            Level = level,
 0331            Framerate = framerate,
 0332            MaxFramerate = maxFramerate,
 0333            CopyTimestamps = copyTimestamps ?? false,
 0334            StartTimeTicks = startTimeTicks,
 0335            Width = width,
 0336            Height = height,
 0337            VideoBitRate = videoBitRate,
 0338            SubtitleStreamIndex = subtitleStreamIndex,
 0339            SubtitleMethod = subtitleMethod ?? SubtitleDeliveryMethod.Encode,
 0340            MaxRefFrames = maxRefFrames,
 0341            MaxVideoBitDepth = maxVideoBitDepth,
 0342            RequireAvc = requireAvc ?? false,
 0343            DeInterlace = deInterlace ?? false,
 0344            RequireNonAnamorphic = requireNonAnamorphic ?? false,
 0345            TranscodingMaxAudioChannels = transcodingMaxAudioChannels,
 0346            CpuCoreLimit = cpuCoreLimit,
 0347            LiveStreamId = liveStreamId,
 0348            EnableMpegtsM2TsMode = enableMpegtsM2TsMode ?? false,
 0349            VideoCodec = videoCodec,
 0350            SubtitleCodec = subtitleCodec,
 0351            TranscodeReasons = transcodeReasons,
 0352            AudioStreamIndex = audioStreamIndex,
 0353            VideoStreamIndex = videoStreamIndex,
 0354            Context = context ?? EncodingContext.Static,
 0355            StreamOptions = streamOptions,
 0356            EnableAudioVbrEncoding = enableAudioVbrEncoding
 0357        };
 358
 0359        return await _audioHelper.GetAudioStream(_transcodingJobType, streamingRequest).ConfigureAwait(false);
 0360    }
 361}
Generated by: ReportGenerator 5.5.7.0
5/6/2026 - 12:15:24 AM
GitHub | reportgenerator.io

Methods/Properties

.ctor(Jellyfin.Api.Helpers.AudioHelper)
GetAudioStream()
GetAudioStreamByContainer()