{"id":25434375,"url":"https://github.com/hassaku/audio-plot","last_synced_at":"2025-11-01T00:30:32.774Z","repository":{"id":57412523,"uuid":"285500945","full_name":"hassaku/audio-plot","owner":"hassaku","description":"Python library to converts a line graph to sound and return an object that can be played in Jupyter notebook or Google Colab. Values are represented by pitches, and the timeline is represented by left and right pans. It was created to make data science fun for the visually impaired.","archived":false,"fork":false,"pushed_at":"2021-04-24T09:40:27.000Z","size":2615,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-14T07:37:31.966Z","etag":null,"topics":["audio-plot","colab","data-science","jupyter-notebook","python","visually-impaired"],"latest_commit_sha":null,"homepage":"https://hassaku.github.io/audio-plot/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hassaku.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-06T07:15:12.000Z","updated_at":"2022-12-09T13:59:29.000Z","dependencies_parsed_at":"2022-08-26T12:33:13.344Z","dependency_job_id":null,"html_url":"https://github.com/hassaku/audio-plot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hassaku%2Faudio-plot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hassaku%2Faudio-plot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hassaku%2Faudio-plot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hassaku%2Faudio-plot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hassaku","download_url":"https://codeload.github.com/hassaku/audio-plot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239133748,"owners_count":19587343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-plot","colab","data-science","jupyter-notebook","python","visually-impaired"],"created_at":"2025-02-17T06:16:31.486Z","updated_at":"2025-11-01T00:30:32.734Z","avatar_url":"https://github.com/hassaku.png","language":"Jupyter Notebook","readme":"**This library is already unmaintained. Please check the following new library that is in development.**\n\nhttps://github.com/hassaku/audio-plot-lib\n\n----\n\n[![Build Status](https://travis-ci.org/hassaku/audio-plot.png)](https://travis-ci.org/hassaku/audio-plot)\n\nConverts a line graph to sound and returns an object that can be played\nin Jupyter notebook or Google Colab.\n\nValues are represented by pitches, and the timeline is represented by left and right pans.\n\nIt was created to make data science fun for the visually impaired.\n\n# Dependency\n\nffmpeg library is needed to provide a descriptive guide to the graph. \n\n## Google Colab\n\nNo additional installation is required.\n\n## Linux\n\n```\n$ sudo apt-get install libavformat-dev libavfilter-dev libavdevice-dev ffmpeg\n```\n\n## Others\n\nIt's under investigation. If you know of any, please make a pull request. Thanks.\n\n# Install\n\n```\n$ pip install audio-plot  # !pip install audio-plot for Colab or Notebook\n```\n\n# Usage\n\nSee and run demo notebook also. [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/hassaku/audio-plot/blob/master/demo.ipynb)\n\n```\ny = np.sin(np.arange(0, np.pi*2, 0.1))\nyy = np.array([y, -y]).T\nplot(yy)  # audio control will be appeared on notebook.\n```\n\n[The audio is as follows for this example]\n```\ntts \u003e minimum value is -1.0\n(Low sinusoidal sound)\ntts \u003e maximum value is 1.0\n(High sinusoidal sound)\ntts \u003e line 1\n(Sound in response to changes in the line 1 graph)\ntts \u003e line 2\n(Sound in response to changes in the line 2 graph)\n```\n\n[Example Results Page](https://hassaku.github.io/audio-plot/)\n\n# Supplement\n\nIf using Jupyter Notebook with a screen reader is inconvenient for you, you may want to consider using the following NVDA add-on.\n\nhttps://github.com/mltony/nvda-browser-nav\n\n# Use in script\n\n```\nfrom pydub.playback import play\n\n# generate graph sound\naudio = audio_plot.plot(two_inverted_sin)\n\n# play\nplay(audio)\n\n# save to audio file\naudio.export(\"graph.wav\", format=\"wav\")\n```\n\n# For contributer\n\n## Update PyPI\n\n```\n$ nosetests -vs\n$ pip install twine # if necessary\n$ cat ~/.pypirc  # if necessary\n[distutils]\nindex-servers = pypi\n\n[pypi]\nrepository: https://upload.pypi.org/legacy/\nusername: YOUR_USERNAME\npassword: YOUR_PASSWORD\n$ rm -rf audio_plot.egg-info dist # if necessary\n$ python setup.py sdist\n$ twine upload --repository pypi dist/*\n$ pip --no-cache-dir install --upgrade audio-plot\n```\n\nhttps://pypi.org/project/audio-plot/\n\n## Contributing\n\n- Fork the repository on Github\n- Create a named feature branch (like add_component_x)\n- Write your change\n- Write tests for your change (if applicable)\n- Run the tests, ensuring they all pass\n- Submit a Pull Request using Github\n\n# License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhassaku%2Faudio-plot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhassaku%2Faudio-plot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhassaku%2Faudio-plot/lists"}