A Python library for playing sound everywhere natively and securely.
Project description
Overview
Nava is a Python library that allows users to play sound in Python without any dependencies or platform restrictions. It is a cross-platform solution that runs on any operating system, including Windows, macOS, and Linux. Its lightweight and easy-to-use design makes Nava an ideal choice for developers looking to add sound functionality to their Python programs.
PyPI Counter |
|
Github Stars |
|
Branch | main | dev |
Linux CI | ||
Windows CI | ||
macOS CI |
Code Quality |
Installation
PyPI
- Check Python Packaging User Guide
- Run
pip install nava==0.5
Source code
- Download Version 0.5 or Latest Source
- Run
pip install .
Conda
- Check Conda Managing Package
- Update Conda using
conda update conda
- Run
conda install -c openscilab nava
Usage
Basic
from nava import play
play("alarm.wav")
Async mode
⚠️ The async_mode
parameter has a default value of False
import time
from nava import play, stop
sound_id = play("alarm.wav", async_mode=True)
time.sleep(4)
stop(sound_id)
Loop mode
⚠️ The loop
parameter has a default value of False
⚠️ You should always set async_mode
flag when you are using loop
from nava import play, stop
sound_id = play("alarm.wav", async_mode=True, loop=True)
time.sleep(100)
stop(sound_id)
Error
from nava import play, NavaBaseError
try:
play("alarm.wav")
except NavaBaseError as e:
print(str(e))
Engine
List of different platforms and the corresponding engines that are used for sound playing.
Platform | Engine | Supported Formats |
---|---|---|
Linux | Advanced Linux Sound Architecture | .wav |
Windows | Winsound | .wav |
macOS | Audio File Play | .wav ,.mp3 |
Issues & bug reports
Just fill an issue and describe it. We'll check it ASAP! or send an email to info@openscilab.com.
- Please complete the issue template
You can also join our discord server
Show your support
Star this repo
Give a ⭐️ if this project helped you!
Donate to our project
If you do like our project and we hope that you do, can you please support us? Our project is not and is never going to be working for profit. We need the money just so we can continue doing what we do ;-) .
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
Unreleased
0.5 - 2024-04-03
Changed
loop
parameter added toplay
functionNavaThread
class modifiedREADME.md
modified
0.4 - 2024-02-19
Added
feature_request.yml
templateconfig.yml
for issue template
Changed
- Bug report template modified
NavaThread.stop
method bug fixed- Test system modified
README.md
modified
0.3 - 2024-01-31
Added
NavaThread
classstop
functionstop_all
function
Changed
async_mode
parameter added toplay
function- Test system modified
README.md
modifiedPython 3.12
added tolinux_test.yml
,macOS_test.yml
andwindows_test.yml
0.2 - 2023-07-10
Added
- Logo
- Anaconda package
Changed
quote
decorator bug fixedpath_check
decorator bug fixed- Test system modified
README.md
modified
0.1 - 2023-06-10
Added
README.md
__play_win
function__play_linux
function__play_mac
functionquote
functionpath_check
functionplay
function
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.