Introduction

This document outlines the process of optimizing audio files, from their initial upload to their final storage in an S3 bucket. The process includes generating random names, optimizing the files, and the ability to customize conversion parameters.

Upload and Optimization Process

1. Audio Upload:

   • When an audio file is uploaded, it is assigned a random name (UUID) with the suffix -original.mp3.
   • Example: q5hXp941OJJ6VNteCy3cHfJINNzZw7UTEwGLX9Ij-original.mp3.

2. Audio Optimization:

   • The original file is processed to create an optimized version with the suffix -optimized.mp3.
   • Example: q5hXp941OJJ6VNteCy3cHfJINNzZw7UTEwGLX9Ij-optimized.mp3.
   • Both the original and optimized files are stored in the S3 bucket. This file is kept and is always used as the base for creating new versions.

3. Default Conversion Parameters:

   • Bitrate: 128 kbps
   • Channels: 2 (Stereo)

Customization of Conversion Parameters

Users can modify the default values through Nova (https://{URL_TENANT}/nova/resources/issues), choosing from the following options:

• Bitrate:

  • 32 kbps, 64 kbps, 96 kbps, 128 kbps, 160 kbps, 192 kbps, 256 kbps, 320 kbps

• Channels:

  • 1 (Mono), 2 (Stereo)

• Processing Mode:

  • Only non-optimized: Processes only new, non-optimized tracks.
  • Force full reprocessing: Reprocesses all tracks, including those already optimized.

Process Information Logging

Upon successful completion of the optimization process, the following information is recorded for each track:

• bitrate: Applied bitrate.
• channels: Number of channels.
• raw_command: Executed console command.
• execution_time: Date and time of execution.

Error Management and Process Continuity

• A processing job (ProcessAudio) is created for each track.
• If a track fails, the process does not stop; the remaining tracks continue to be processed.

---