Skip to content

A Python package to provide suggestion on volume at which the music audio file needs to be played for better experience and feeling.

License

Notifications You must be signed in to change notification settings

akash-rajak/PyVolSuggester

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

✔ PyVolSuggester Package

  • A Python package to provide suggestion on volume at which the music audio file needs to be played for better experience and feeling.
  • In backend, it extracts various generic features for particular audio and analyze among them and provide feedback on volumne on it.
  • This tools helps in maintaining good vibes along the music playout.

PyVolSuggester PyPi

GitHub Repo stars GitHub Repo forks GitHub Repo watchers GitHub contributors

GitHub language count GitHub top language GitHub repo file count GitHub repo size

GitHub issues GitHub closed issues GitHub pull requests GitHub closed pull requests

GitHub commit activity GitHub commit activity/year GitHub commit activity/month GitHub commit activity/week GitHub last commit GitHub Discussions

PyPI - Downloads per day PyPI - Downloads per week PyPI - Downloads per month

PyPI Version PyPI - Implementation PyPI - Python Version PyPI - Format PyPI - Status

GitHub all releases GitHub release version (latest by date) GitHub tag (latest by date) GitHub Release Date GitHub (Pre-)Release Date

Github

image


📌How this Script works :

  • First user need to download the script and run Volume Suggester.py in the local system.
  • After running it, user will be prompted to select an audio file(mp3 file) using dialog box.
  • Once user has selected the audio file, following feature extraction and analysis graph will be generated at the backend.
    • Generic Audio Features:
      • Channels : (number of channels; 1 for mono, 2 for stereo audio)
      • Sample Width : (number of bytes per sample; 1 means 8-bit, 2 means 16-bit)
      • Frame Rate / Sample Rate : (frequency of samples used (in Hertz))
      • Frame Width : (Number of bytes for each “frame”. One frame contains a sample for each channel.)
      • Audio Length / Duration : (audio file length (in milliseconds))
      • Frame Count : (the number of frames from the sample)
      • Intensity : (loudness in dBFS (dB relative to the maximum possible loudness))
    • Plot on Amplitude over Time Analysis
    • Following Derived Audio Features:
      • Spectogram
      • RMS/Energy Spectogram
      • Zero Crossing Rate
      • Mel Frequency Cepstral Coefficients
      • Mel Frequency Spectogram
      • Chroma Feature
      • Tempogram
  • After these feature extraction is done, user will be able to Play/Pause(using CTRL button) and Stop(using ESC button) the selected song.

📌Input/Output Deliverables:

- Input: 
    - Single Audio File (.mp3)

- Output:
    - Output Folder consisting of different feature extraction

📌Features:

  • Implemented following features in the package:
    1. Generic Audio Features:

      • Channels : (number of channels; 1 for mono, 2 for stereo audio)
      • Sample Width : (number of bytes per sample; 1 means 8-bit, 2 means 16-bit)
      • Frame Rate / Sample Rate : (frequency of samples used (in Hertz))
      • Frame Width : (Number of bytes for each “frame”. One frame contains a sample for each channel.)
      • Audio Length / Duration : (audio file length (in milliseconds))
      • Frame Count : (the number of frames from the sample)
      • Intensity : (loudness in dBFS (dB relative to the maximum possible loudness))
    2. Derived Audio Features:

      • Amplitude over Time
      • Spectogram
      • RMS/Energy Spectogram
      • Zero Crossing Rate
      • Mel Frequency Cepstral Coefficients
      • Mel Frequency Spectogram
      • Chroma Feature
      • Tempogram
    3. Player for playing selected audio file

    4. Suggestion on volume on the basis of various feature extraction.


📌Prerequisites:

  • In order to use this package, one need to ensure the following requirements:
    • Python 3.7 or later installed on your machine.
    • ffmpeg pacakge must be installed and its PATH must be added to Environment variables.

📌Package Usage

This command will import the PyVolSuggester module.

import PyVolSuggester

This command will install all the uninstalled required libraries used in script.

from PyVolSuggester import Suggester

This will prompt user for input of ffmpeg path and audio file selection(.wav format).

Suggester.main()

This will extract the generic features of the selected audio file.

Suggester.extract()

This will allow user to play, plause and stop the audio file.

Suggester.play_pause_stop()

This will generate a amplitude over time plot and save it as an image to output directory.

Suggester.amplitude_wave()

This will generate a spectogram plot and save it as an image to output directory.

Suggester.spectogram()

This will generate a RMS/Energy Spectogram plot and save it as an image to output directory.

Suggester.rms_energy_spectogram()

This will generate a Zero Crossing Rate plot and save it as an image to output directory.

Suggester.zero_crossing_rate()

This will generate a Mel Frequency Cepstral Coefficients plot and save it as an image to output directory.

Suggester.mel_frequency_cepstral_coefficients()

This will generate a Mel Frequency Spectogram plot and save it as an image to output directory.

Suggester.mel_frequency_spectogram()

This will generate a Chroma Feature plot and save it as an image to output directory.

Suggester.chroma_feature()

This will generate a tempogram plot and save it as an image to output directory.

Suggester.tempogram()

This will suggest user the most feasible volume for that particular audio.

Suggester.suggest_volume()

📌Package Installation

pip install PyVolSuggester

🌟Stargazers Over Time:

Stargazers repo roster for @akash-rajak/PyVolSuggester Stargazers over time


🌟Forkers Over Time:

Forkers repo roster for @akash-rajak/PyVolSuggester


📌Contributors:

About

A Python package to provide suggestion on volume at which the music audio file needs to be played for better experience and feeling.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages