audiodl-mp3
v4.5.0
Published
A reliable YouTube to MP3 downloader with direct API integration, authenticated sessions, and automatic ID3 tagging. No more broken ytdl dependencies!
Maintainers
Readme
��#� �A�u�d�i�o�D�L�-�M�P�3� �v�4�.�0�.�1� �<ص�
�
�A� ���r�e�l�i�a�b�l�e��� �Y�o�u�T�u�b�e� �t�o� �M�P�3� �d�o�w�n�l�o�a�d�e�r� �t�h�a�t� �e�l�i�m�i�n�a�t�e�s� �d�e�p�e�n�d�e�n�c�y� �o�n� �p�r�o�b�l�e�m�a�t�i�c� �y�t�d�l� �l�i�b�r�a�r�i�e�s� �b�y� �i�m�p�l�e�m�e�n�t�i�n�g� �d�i�r�e�c�t� �Y�o�u�T�u�b�e� �A�P�I� �i�n�t�e�g�r�a�t�i�o�n� �w�i�t�h� ���c�o�o�k�i�e�-�o�n�l�y� �a�u�t�h�e�n�t�i�c�a�t�i�o�n���.�
�
�#�#� �=� �K�e�y� �F�e�a�t�u�r�e�s�
�
�' ���N�o� �M�o�r�e� �B�r�o�k�e�n� �D�e�p�e�n�d�e�n�c�i�e�s��� �-� �D�i�r�e�c�t� �Y�o�u�T�u�b�e� �A�P�I� �i�n�t�e�g�r�a�t�i�o�n� � �
�' ���C�o�o�k�i�e�-�O�n�l�y� �A�u�t�h�e�n�t�i�c�a�t�i�o�n��� �-� �S�i�m�p�l�e� �s�e�t�u�p� �w�i�t�h� �j�u�s�t� �y�o�u�r� �b�r�o�w�s�e�r� �c�o�o�k�i�e�s� � �
�' ���A�u�t�o�m�a�t�i�c� �R�e�t�r�i�e�s��� �-� �B�u�i�l�t�-�i�n� �r�e�t�r�y� �m�e�c�h�a�n�i�s�m�s� �w�i�t�h� �e�x�p�o�n�e�n�t�i�a�l� �b�a�c�k�o�f�f� � �
�' ���S�m�a�r�t� �F�o�r�m�a�t� �S�e�l�e�c�t�i�o�n��� �-� �I�n�t�e�l�l�i�g�e�n�t� �a�u�d�i�o� �f�o�r�m�a�t� �s�e�l�e�c�t�i�o�n� �f�o�r� �b�e�s�t� �q�u�a�l�i�t�y� � �
�' ���I�D�3� �T�a�g� �S�u�p�p�o�r�t��� �-� �A�u�t�o�m�a�t�i�c� �m�e�t�a�d�a�t�a� �f�r�o�m� �i�T�u�n�e�s� �A�P�I� �w�i�t�h� �a�l�b�u�m� �a�r�t�w�o�r�k� � �
�' ���S�e�s�s�i�o�n� �H�e�a�l�t�h� �C�h�e�c�k�s��� �-� �B�u�i�l�t�-�i�n� �v�a�l�i�d�a�t�i�o�n� �a�n�d� �t�r�o�u�b�l�e�s�h�o�o�t�i�n�g� � �
�' ���T�y�p�e�S�c�r�i�p�t� �S�u�p�p�o�r�t��� �-� �F�u�l�l� �t�y�p�e� �d�e�f�i�n�i�t�i�o�n�s� �i�n�c�l�u�d�e�d� � �
�
�#�#� �=��� �I�n�s�t�a�l�l�a�t�i�o�n�
�
����b�a�s�h�
�n�p�m� �i�n�s�t�a�l�l� �a�u�d�i�o�d�l�-�m�p�3�
����
�
�#�#� �<د� �Q�u�i�c�k� �S�t�a�r�t�
�
����j�a�v�a�s�c�r�i�p�t�
�c�o�n�s�t� �{� �D�o�w�n�l�o�a�d�e�r� �}� �=� �r�e�q�u�i�r�e�(�'�a�u�d�i�o�d�l�-�m�p�3�'�)�;�
�
�c�o�n�s�t� �d�o�w�n�l�o�a�d�e�r� �=� �n�e�w� �D�o�w�n�l�o�a�d�e�r�(�{�
� � �o�u�t�p�u�t�D�i�r�:� �'�.�/�d�o�w�n�l�o�a�d�s�'�,�
� � �g�e�t�T�a�g�s�:� �t�r�u�e�
�}�)�;�
�
�/�/� �D�o�w�n�l�o�a�d� �a� �s�o�n�g�
�a�w�a�i�t� �d�o�w�n�l�o�a�d�e�r�.�d�o�w�n�l�o�a�d�S�o�n�g�(�'�h�t�t�p�s�:�/�/�w�w�w�.�y�o�u�t�u�b�e�.�c�o�m�/�w�a�t�c�h�?�v�=�d�Q�w�4�w�9�W�g�X�c�Q�'�)�;�
����
�
�#�#� �=�� �C�o�o�k�i�e�-�O�n�l�y� �S�e�t�u�p�
�
���v�4�.�0�.�1��� �u�s�e�s� �o�n�l�y� �c�o�o�k�i�e�s� �f�o�r� �a�u�t�h�e�n�t�i�c�a�t�i�o�n� �-� �n�o� �c�o�m�p�l�e�x� �t�o�k�e�n�s� �n�e�e�d�e�d�!�
�
�1�.� ���I�n�s�t�a�l�l� �"�G�e�t� �c�o�o�k�i�e�s�.�t�x�t�"��� �b�r�o�w�s�e�r� �e�x�t�e�n�s�i�o�n�
�2�.� ���V�i�s�i�t� �Y�o�u�T�u�b�e��� �a�n�d� �l�o�g� �i�n� �t�o� �y�o�u�r� �a�c�c�o�u�n�t�
�3�.� ���E�x�p�o�r�t� �c�o�o�k�i�e�s��� �a�s� �J�S�O�N� �f�o�r�m�a�t�
�4�.� ���S�a�v�e� �a�s��� ��s�r�c�/�c�o�o�k�i�e�s�.�j�s�o�n�� �i�n� �y�o�u�r� �p�r�o�j�e�c�t�
�
����b�a�s�h�
�#� �T�e�s�t� �y�o�u�r� �s�e�t�u�p�
�n�p�m� �r�u�n� �b�u�i�l�d�
�n�o�d�e� �t�e�s�t�-�d�o�w�n�l�o�a�d�.�j�s�
����
�
�#�#� �=��� �D�o�c�u�m�e�n�t�a�t�i�o�n�
�
�-� ���[�C�o�m�p�l�e�t�e� �U�s�a�g�e� �G�u�i�d�e�]�(�U�S�A�G�E�_�G�U�I�D�E�.�m�d�)��� �-� �C�o�m�p�r�e�h�e�n�s�i�v�e� �d�o�c�u�m�e�n�t�a�t�i�o�n�
�-� ���[�M�i�g�r�a�t�i�o�n� �G�u�i�d�e�]�(�U�S�A�G�E�_�G�U�I�D�E�.�m�d�#�m�i�g�r�a�t�i�o�n�-�f�r�o�m�-�v�3�x�)��� �-� �U�p�g�r�a�d�i�n�g� �f�r�o�m� �v�3�.�x�
�-� ���[�T�r�o�u�b�l�e�s�h�o�o�t�i�n�g�]�(�U�S�A�G�E�_�G�U�I�D�E�.�m�d�#�t�r�o�u�b�l�e�s�h�o�o�t�i�n�g�)��� �-� �C�o�m�m�o�n� �i�s�s�u�e�s� �a�n�d� �s�o�l�u�t�i�o�n�s�
�
�#�#� �>��� �T�e�s�t�i�n�g�
�
����b�a�s�h�
�#� �B�u�i�l�d� �t�h�e� �p�r�o�j�e�c�t�
�n�p�m� �r�u�n� �b�u�i�l�d�
�
�#� �R�u�n� �t�e�s�t� �d�o�w�n�l�o�a�d�
�n�o�d�e� �t�e�s�t�-�d�o�w�n�l�o�a�d�.�j�s�
����
�
�#�#� �<ؚ� �W�h�a�t�'�s� �N�e�w� �i�n� �v�4�.�0�.�1�?�
�
�#�#�#� �L' �B�e�f�o�r�e� �(�v�3�.�x� �-� �C�o�m�p�l�e�x� �&� �U�n�r�e�l�i�a�b�l�e�)�
�-� �D�e�p�e�n�d�e�n�t� �o�n� �b�r�e�a�k�i�n�g� �y�t�d�l� �l�i�b�r�a�r�i�e�s�
�-� �R�e�q�u�i�r�e�d� �c�o�m�p�l�e�x� �t�o�k�e�n� �m�a�n�a�g�e�m�e�n�t� �(�p�o�T�o�k�e�n�,� �v�i�s�i�t�o�r�D�a�t�a�)�
�-� �F�r�e�q�u�e�n�t� �f�a�i�l�u�r�e�s� �d�u�e� �t�o� �Y�o�u�T�u�b�e� �c�h�a�n�g�e�s�
�-� �C�o�m�p�l�e�x� �p�r�o�x�y� �s�e�t�u�p�s� �r�e�q�u�i�r�e�d�
�
�#�#�#� �' �A�f�t�e�r� �(�v�4�.�0�.�1� �-� �S�i�m�p�l�e� �&� �R�e�l�i�a�b�l�e�)�
�-� �D�i�r�e�c�t� �Y�o�u�T�u�b�e� �A�P�I� �i�n�t�e�g�r�a�t�i�o�n�
�-� ���C�o�o�k�i�e�-�o�n�l�y� �a�u�t�h�e�n�t�i�c�a�t�i�o�n��� �(�n�o� �m�o�r�e� �t�o�k�e�n�s�!�)�
�-� �A�u�t�o�-�e�x�t�r�a�c�t�i�o�n� �o�f� �v�i�s�i�t�o�r� �d�a�t�a� �f�r�o�m� �c�o�o�k�i�e�s�
�-� �B�u�i�l�t�-�i�n� �s�e�s�s�i�o�n� �h�e�a�l�t�h� �c�h�e�c�k�s�
�-� �C�l�e�a�n�,� �m�a�i�n�t�a�i�n�a�b�l�e� �c�o�d�e�b�a�s�e�
�
�#�#� �=���� �A�d�v�a�n�c�e�d� �U�s�a�g�e�
�
�#�#�#� �S�e�s�s�i�o�n� �H�e�a�l�t�h� �C�h�e�c�k�
�
����j�a�v�a�s�c�r�i�p�t�
�c�o�n�s�t� �{� �S�e�s�s�i�o�n�M�a�n�a�g�e�r� �}� �=� �r�e�q�u�i�r�e�(�'�a�u�d�i�o�d�l�-�m�p�3�'�)�;�
�
�c�o�n�s�t� �s�e�s�s�i�o�n� �=� �S�e�s�s�i�o�n�M�a�n�a�g�e�r�.�l�o�a�d�F�r�o�m�F�i�l�e�(�'�.�/�c�o�o�k�i�e�s�.�j�s�o�n�'�)�;�
�c�o�n�s�t� �i�s�V�a�l�i�d� �=� �a�w�a�i�t� �S�e�s�s�i�o�n�M�a�n�a�g�e�r�.�v�a�l�i�d�a�t�e�S�e�s�s�i�o�n�(�s�e�s�s�i�o�n�)�;�
�c�o�n�s�o�l�e�.�l�o�g�(�'�S�e�s�s�i�o�n� �v�a�l�i�d�:�'�,� �i�s�V�a�l�i�d�)�;�
����
�
�#�#�#� �C�u�s�t�o�m� �C�o�n�f�i�g�u�r�a�t�i�o�n�
�
����j�a�v�a�s�c�r�i�p�t�
�c�o�n�s�t� �d�o�w�n�l�o�a�d�e�r� �=� �n�e�w� �D�o�w�n�l�o�a�d�e�r�(�{�
� � �o�u�t�p�u�t�D�i�r�:� �'�.�/�m�u�s�i�c�'�,�
� � �g�e�t�T�a�g�s�:� �t�r�u�e�,�
� � �r�e�t�r�i�e�s�:� �5�,�
� � �t�i�m�e�o�u�t�:� �6�0�0�0�0�,�
� � �c�o�o�k�i�e�s�:� �m�y�C�o�o�k�i�e�s�
�}�)�;�
����
�
�#�#�#� �B�a�t�c�h� �D�o�w�n�l�o�a�d�s�
�
����j�a�v�a�s�c�r�i�p�t�
�c�o�n�s�t� �u�r�l�s� �=� �[�'�u�r�l�1�'�,� �'�u�r�l�2�'�,� �'�u�r�l�3�'�]�;�
�
�f�o�r� �(�c�o�n�s�t� �u�r�l� �o�f� �u�r�l�s�)� �{�
� � �t�r�y� �{�
� � � � �a�w�a�i�t� �d�o�w�n�l�o�a�d�e�r�.�d�o�w�n�l�o�a�d�S�o�n�g�(�u�r�l�)�;�
� � � � �a�w�a�i�t� �n�e�w� �P�r�o�m�i�s�e�(�r�e�s�o�l�v�e� �=�>� �s�e�t�T�i�m�e�o�u�t�(�r�e�s�o�l�v�e�,� �2�0�0�0�)�)�;� �/�/� �R�e�s�p�e�c�t�f�u�l� �d�e�l�a�y�
� � �}� �c�a�t�c�h� �(�e�r�r�o�r�)� �{�
� � � � �c�o�n�s�o�l�e�.�e�r�r�o�r�(��F�a�i�l�e�d�:� �$�{�u�r�l�}��,� �e�r�r�o�r�)�;�
� � �}�
�}�
����
�
�#�#� �>�� �C�o�n�t�r�i�b�u�t�i�n�g�
�
�1�.� �F�o�r�k� �t�h�e� �r�e�p�o�s�i�t�o�r�y�
�2�.� �C�r�e�a�t�e� �a� �f�e�a�t�u�r�e� �b�r�a�n�c�h�
�3�.� �M�a�k�e� �y�o�u�r� �c�h�a�n�g�e�s�
�4�.� �A�d�d� �t�e�s�t�s�
�5�.� �S�u�b�m�i�t� �a� �p�u�l�l� �r�e�q�u�e�s�t�
�
�#�#� �=��� �L�i�c�e�n�s�e�
�
�M�I�T� �L�i�c�e�n�s�e� �-� �s�e�e� �[�L�I�C�E�N�S�E�]�(�L�I�C�E�N�S�E�)� �f�i�l�e� �f�o�r� �d�e�t�a�i�l�s�.�
�
�#�#� �=�O� �A�c�k�n�o�w�l�e�d�g�m�e�n�t�s�
�
�-� �F�F�m�p�e�g� �f�o�r� �a�u�d�i�o� �c�o�n�v�e�r�s�i�o�n�
�-� �i�T�u�n�e�s� �A�P�I� �f�o�r� �m�e�t�a�d�a�t�a�
�-� �Y�o�u�T�u�b�e� �f�o�r�.�.�.� �b�e�i�n�g� �Y�o�u�T�u�b�e�
�
�-�-�-�
�
���N�o�t�e���:� �T�h�i�s� �p�a�c�k�a�g�e� �i�s� �f�o�r� �e�d�u�c�a�t�i�o�n�a�l� �p�u�r�p�o�s�e�s�.� �R�e�s�p�e�c�t� �Y�o�u�T�u�b�e�'�s� �T�e�r�m�s� �o�f� �S�e�r�v�i�c�e� �a�n�d� �c�o�p�y�r�i�g�h�t� �l�a�w�s�.�
�
