Skip to content

pkg_resources deprecation warning in manim-voiceover #116

@effuone

Description

@effuone

Description of bug / unexpected behavior

manim-voiceover displays a deprecation warning about pkg_resources being deprecated. This warning appears every time manim-voiceover is imported and indicates that the library will break when setuptools 81+ is released (as early as 2025-11-30).

Expected behavior

No deprecation warnings should appear when importing or using manim-voiceover.

How to reproduce the issue

Simply import manim-voiceover or create any scene that uses voiceover functionality.

Code for reproducing the problem
from manim import *
from manim_voiceover import VoiceoverScene
from manim_voiceover.services.elevenlabs import ElevenLabsService

class TestScene(VoiceoverScene):
    def construct(self):
        self.set_speech_service(ElevenLabsService(
            voice_name="Adam",
            api_key="your_api_key_here",
            transcription_model=None
        ))
        
        with self.voiceover(text="Hello world") as tracker:
            self.play(Write(Text("Hello")), run_time=tracker.duration)

Additional media files

Images/GIFs

N/A - This is a warning message issue, not a visual rendering problem.

Logs

Terminal output
/path/to/site-packages/manim_voiceover/__init__.py:4: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81.
  import pkg_resources

System specifications

System Details
  • OS: Linux
  • Python version: 3.13
  • Installed modules:
manim==0.19.0
manim-voiceover[elevenlabs]==0.3.7
setuptools>=80.9.0
LaTeX details
  • LaTeX distribution: TeX Live 2023
  • Installed LaTeX packages: Standard distribution
FFMPEG

Output of ffmpeg -version:

ffmpeg version 4.4.x or later (standard installation)

Additional comments

The issue stems from manim-voiceover using the deprecated pkg_resources API in its __init__.py file. The solution would be to migrate to importlib.metadata which is the recommended replacement. This affects all users with recent setuptools versions and will become a breaking issue when setuptools 81+ removes pkg_resources entirely.

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions