How do I control output folders and file names?

[aradalvand]

The Overview > Features section in the docs says that Shaka Streamer lets you:

Control output folders and file names

But I couldn't find any relevant options in https://shaka-project.github.io/shaka-streamer/configuration_fields.html.
With Shaka Packager, I used to use playlist_name, and segment_template with placeholders like $Number$ in its value.
How do I achieve the same thing with Shaka Streamer?

[mariocynicys]

These are the options you can play with:

shaka-streamer/streamer/pipeline_configuration.py

Lines 292 to 299 in c6c5b92

	dash_output = configuration.Field(str, default='dash.mpd').cast()
	"""Output filename for the DASH manifest, if created."""
	hls_output = configuration.Field(str, default='hls.m3u8').cast()
	"""Output filename for the HLS master playlist, if created."""
	segment_folder = configuration.Field(str, default='').cast()
	"""Sub-folder for segment output (or blank for none)."""

But media file names are hard coded to a predefined template:

shaka-streamer/streamer/output_stream.py

Lines 64 to 89 in c6c5b92

	def get_init_seg_file(self) -> Pipe:
	INIT_SEGMENT = {
	MediaType.AUDIO: 'audio_{language}_{channels}c_{bitrate}_{codec}_init.{format}',
	MediaType.VIDEO: 'video_{resolution_name}_{bitrate}_{codec}_init.{format}',
	MediaType.TEXT: 'text_{language}_init.{format}',
	}
	path_templ = INIT_SEGMENT[self.type].format(**self.features)
	return Pipe.create_file_pipe(path_templ, mode='w')
	def get_media_seg_file(self) -> Pipe:
	MEDIA_SEGMENT = {
	MediaType.AUDIO: 'audio_{language}_{channels}c_{bitrate}_{codec}_$Number$.{format}',
	MediaType.VIDEO: 'video_{resolution_name}_{bitrate}_{codec}_$Number$.{format}',
	MediaType.TEXT: 'text_{language}_$Number$.{format}',
	}
	path_templ = MEDIA_SEGMENT[self.type].format(**self.features)
	return Pipe.create_file_pipe(path_templ, mode='w')
	def get_single_seg_file(self) -> Pipe:
	SINGLE_SEGMENT = {
	MediaType.AUDIO: 'audio_{language}_{channels}c_{bitrate}_{codec}.{format}',
	MediaType.VIDEO: 'video_{resolution_name}_{bitrate}_{codec}.{format}',
	MediaType.TEXT: 'text_{language}.{format}',
	}
	path_templ = SINGLE_SEGMENT[self.type].format(**self.features)
	return Pipe.create_file_pipe(path_templ, mode='w')

[aradalvand]

Yes but none of those correspond to segment_template or playlist_name in Shaka Packager.
Setting segment_folder just moves all the segments into a single folder; whereas segment_template in Shaka Packager would've allowed you to put the segments of each stream into its own directory.
Likewise, hls_output corresponds to the --hls_master_playlist_output argument in Shaka Packager, which as the name implies determines the name of the master playlist. playlist_name in Shaka Packager on the other hand, specifies the name of the playlist file of an individual stream.

Update: I hadn't read the second part of your answer where you actually did mention this:

But media file names are hard coded to a predefined template:

Well, that's a bummer, I thought I was missing something. That's exactly what I needed :/
Any plans to add the ability to customize this in the future?

[joeyparrish]

It's not planned, but PRs are welcome. We could maybe move the filename templates into the configuration, with the current templates as default.

[joeyparrish]

PRs still welcome!

[tomatotomata]

I was thinking of extending the existing segment_folder output option with configurable per-stream filename templates, while preserving the current defaults and leaving manifest naming unchanged. I would keep the change in PipelineConfig and PackagerNode, document the supported placeholders, and add focused config/argument tests. The goal is to cover the segment_template use case without changing the default output layout. Does that fit what you had in mind for this issue?