Contents

2. Core features

Ultra‑light Win 2.5MB · macOS 3.36MB · Linux ready
4 formats MP3/FLAC/OGG/WAV
Precise metadata WAV/FLAC 100%
Non‑blocking perfect for GUIs

📦 Size comparison

  • 🟢 ap_ds Windows: 2.5MB (SDL2.dll 2.1MB + mixer 400KB + py 42KB)
  • 🍎 macOS: 3.36MB (SDL2.framework 1.82MB + mixer 1.54MB + py 42KB)
  • 🐧 Linux: dynamically linked system SDL2, package ~50KB (needs libsdl2-mixer)
  • 🔴 FFmpeg approach: ≥160MB (ffplay+ffprobe)
  • 🟡 Pygame + parsing libs: bloated and incomplete

⚙️ Why so tiny?

  • Focused: playback only, no editing/transcoding
  • Built on industrial‑grade SDL2
  • Optimised to the byte
  • cross‑platform W/M/L

3. Technical comparison

Chapter 1: Pygame – the "audio handicap" of a game engine

# Pygame's unreliable audio duration
my_sound = pygame.mixer.Sound('my_song.mp3')
total_length = my_sound.get_length()  # reliable only for uncompressed WAV!
⚠️ Pygame's Sound.get_length() works correctly only for WAV; MP3/OGG/FLAC return nonsense.

Chapter 2: The FFmpeg suite – 160MB "at least" pain

ComponentFunctionSizeTotal
ffplay.exeplayback core≈80MB≥160MB
ffprobe.exemetadata probe≈80MB
ffmpeg.execonverter≈80MB≥240MB
🔍 Truth: three standalone executables, no Python wrapper included.

Chapter 3: The ap_ds revolution

Seven technical breakthroughs

  1. ✓ 2.5MB solves 160MB problem
  2. ✓ non‑blocking eliminates GUI lag
  3. ✓ precise progress queries
  4. ✓ zero‑dependency deployment
  5. ✓ AID multi‑audio management
  6. ✓ SDL2 performance
  7. ✓ smart C deps cross‑platform

4. Installation & usage

pip install ap_ds

Basic example

from ap_ds import AudioLibrary
lib = AudioLibrary()
aid = lib.play_from_file("music.mp3")
lib.pause_audio(aid)
lib.seek_audio(aid, 30.5)
duration = lib.stop_audio(aid)

DAP playlist (v2.3.0+)

aid1 = lib.play_from_file("song1.mp3")
recordings = lib.get_dap_recordings()
lib.save_dap_to_json("my_playlist.ap-ds-dap")

5. Technical manual

6. Open Source License

DVS Audio Library (ap_ds) Open Source License Version 2.0

Version: 2.0
Effective Date: March 22, 2026
Applies to: ap_ds version 2.4.1 and above (except for subsequent license updates)
Project Homepage: https://www.dvsyun.top/ap_ds | https://apds.top

1. Definitions

1.1. “Software” means the DVS Audio Library (ap_ds) project and all its components, source code, object code, and related documentation. The official name of this project is “ap_ds”, and the following names are also granted as officially recognized brand identifiers: AP_DS, Audio Library By DVS, DVS Audio Player (all case-insensitive).

1.2. “Source Code” means the human-readable form of the Software, which is the basis for modification, study, and distribution.

1.3. “Modified Version” means any derivative work created by modifying, supplementing, translating, or otherwise altering the Software, in whole or in part.

1.4. “Distribute” means making the Software or a Modified Version available to any third party by any means or medium.

1.5. “You” means any individual or legal entity exercising the rights granted under this License.

1.6. “Independent Brand” means a completely new project name, logo, and brand identity that has no confusing association with the official names of the Software (including but not limited to “ap_ds”, “AP_DS”, “Audio Library By DVS”, “DVS Audio Player”, and any variants thereof).

2. Grant of License

Subject to the terms and conditions of this License, the Author hereby grants You a perpetual, worldwide, royalty-free, non-exclusive, irrevocable right to: Use and Run; Copy and Distribute; Study and Modify; Integrate and Commercially Use (including commercial product integration, cloud service deployment, selling solutions, and internal corporate use).

3. Obligations and Restrictions

3.1. Attribution and Source Identification: Any time the Software or a Modified Version is used, Distributed, or integrated, You must: (a) Retain Original Copyright Notices; (b) Provide Prominent Source Attribution stating: “Based on DVS Audio Library (ap_ds) v[version number] Original Author: Dvs (DvsXT) Project Homepage: https://www.dvsyun.top/ap_ds | https://apds.top”; (c) For Modified Versions, add: “This is a modified version maintained by [Your Name/Organization]. Support: [Your Contact Information]. This version is not the official version and is not affiliated with the original author.”

3.2. Brand Protection (strict): You must not name a Modified Version “ap_ds”, “AP_DS”, “Audio Library By DVS”, “DVS Audio Player”, or any variant. Modified Versions must use a completely independent brand and establish independent identity. The distributor must state prominently: “This project is based on DVS Audio Library (ap_ds) but has evolved independently and is fully maintained by [Your Name]. For the original version, please visit: https://www.dvsyun.top/ap_ds or https://apds.top. The maintainer is solely responsible for any issues.”

3.3. Quality Commitment for Modified Versions: Clearly state modifications, provide technical support, and not mislead users.

3.4. Prohibited Uses: No illegal activities, malware, or infringement.

4. Patent Grant & Defense Termination

Author grants a worldwide, royalty-free patent license. If You file a patent lawsuit against the Author regarding the Software, all rights terminate automatically.

5. Technical Transparency and Security

Security audits allowed; reporting security issues to me@dvsyun.top encouraged; no backdoors commitment.

6. Disclaimer of Warranty and Limitation of Liability

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND. TO THE FULLEST EXTENT PERMITTED BY LAW, THE AUTHOR SHALL NOT BE LIABLE FOR ANY DAMAGES.

7. License Management and Termination

Version 2.0; compatible with MIT, BSD 3-Clause, Apache 2.0. Automatic termination upon non-compliance, with a 30-day cure period.

8. Governing Law and Dispute Resolution

Governed by laws of the People's Republic of China. Disputes resolved through negotiation or at the competent court in the author's domicile.

9. Contact Information

Licensing: me@dvsyun.top or dvs6666@163.com · Project: https://www.dvsyun.top/ap_ds | https://apds.top

BY USING, COPYING, MODIFYING, OR DISTRIBUTING THE SOFTWARE, YOU ACCEPT ALL TERMS AND CONDITIONS OF THIS LICENSE.


✅ You may commercial use, modify, closed‑source integration, sell, distribute modified versions (independent brand), cloud service, internal use
❌ You may not use original brand name, delete copyright, illegal purposes, sue for patent infringement, create confusion
👍 You should retain copyright, attribute source, report security issues, create independent brand for modified version

7. Frequently asked questions

Q: Can a company integrate it in commercial products?

✅ Absolutely, no payment / notice / authorisation required.

Q: Can I modify and redistribute it?

✅ Yes, but you must use an independent brand, retain copyright, attribute, and provide maintainer statement.

Q: Do I have to open‑source my modifications?

❌ No, you may distribute closed‑source.

Q: Do I need to pay for cloud service usage?

❌ No, but contributions are welcome.

Q: What if I get sued for patent infringement?

📞 Contact the author immediately: me@dvsyun.top (backup dvs6666@163.com)

Q: Why such strict brand protection?

To protect users from confusion and ensure clear responsibility for each version.

8. Contact & support

📧 Licensing inquiries

me@dvsyun.top or dvs6666@163.com · response within 7 business days

🛠️ Technical support

GitHub Issues · docs at official site · emergency email

Official Repositories & Project Sources

✅ Recommended (Primary): Gitee (China, fast & stable)actively maintained mirror

✅ Recommended (Backup): GitLab (JihuLab)secondary official repository

❌ Not recommended (Deprecated): GitHub (dvs-web/ap_ds)abandoned / no longer maintained. Use Gitee or JihuLab instead.

ap_ds v2.4.1 & v2.4.0 – official homepage note

In versions 2.4.0 and 2.4.1, the "official website" displayed inside the library documentation / console refers to the developer's personal page & blog: – a space where Dvs shares technology insights, life notes, and project philosophy.

For the dedicated ap_ds project homepage, please visit: https://apds.top (official documentation, releases, and license center).

🔗 Canonical URL: https://apds.top/ 📖 Blog & about author: dvsx.top – “DVS · Blog: recording tech & life, sharing knowledge and insights”

About the author

Developer: Dvs (DvsXT)

Personal homepage & blog:
— DVS · Blog: recording technology & life, sharing knowledge and insights

Author profile: https://dvsyun.top/me/dvs

Email: me@dvsyun.top · dvs6666@163.com

ap_ds official portals

🎵 ap_ds official website 1 (primary): https://apds.top

🌐 Official website 2 (mirror / docs): https://www.dvsyun.top/ap_ds

📦 PyPI project page: https://pypi.org/project/ap_ds/

👉 The dedicated ap_ds project homepage (apds.top) hosts the full documentation, license details, version changelog, and official releases. The author's personal blog (dvsx.top) contains technical essays, life stories, and project background.