{"id":25314065,"url":"https://github.com/michaelakridge-noaa/sud2wav","last_synced_at":"2026-05-10T07:40:19.319Z","repository":{"id":248763866,"uuid":"829209254","full_name":"MichaelAkridge-NOAA/SUD2WAV","owner":"MichaelAkridge-NOAA","description":"SUD2WAV - .SUD file to .WAV file Converter using docker, python \u0026 Java-based conversion library","archived":false,"fork":false,"pushed_at":"2024-07-23T20:09:12.000Z","size":3068,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T16:54:26.645Z","etag":null,"topics":["docker-image","java","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MichaelAkridge-NOAA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-16T01:34:44.000Z","updated_at":"2025-02-01T19:48:50.000Z","dependencies_parsed_at":"2024-07-23T22:54:40.287Z","dependency_job_id":null,"html_url":"https://github.com/MichaelAkridge-NOAA/SUD2WAV","commit_stats":null,"previous_names":["michaelakridge-noaa/sud2wav"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAkridge-NOAA%2FSUD2WAV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAkridge-NOAA%2FSUD2WAV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAkridge-NOAA%2FSUD2WAV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAkridge-NOAA%2FSUD2WAV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichaelAkridge-NOAA","download_url":"https://codeload.github.com/MichaelAkridge-NOAA/SUD2WAV/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247668997,"owners_count":20976307,"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":["docker-image","java","python"],"created_at":"2025-02-13T16:54:27.362Z","updated_at":"2025-10-29T20:46:57.026Z","avatar_url":"https://github.com/MichaelAkridge-NOAA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SUD2WAV | SUD to WAV Converters\n- Option 1: A Python web app to convert `.sud` files to `.wav` files using docker \u0026 Java-based conversion library\n- Option 2: An automated conversion process using GitHub Action Workflow \n\n\u003cimg src=\"https://github.com/MichaelAkridge-NOAA/SUD2WAV/raw/main/docs/s00.png\" width=\"720\"/\u003e\n\n\n## Table of Contents\n- [Option 1. Using the Python Web App via Docker](#option-1-using-the-python-web-app-via-docker)\n  - [Prerequisites](#prerequisites)\n  - [Setup](#setup)\n  - [Accessing the Web Application](#accessing-the-web-application)\n- [Option 2. Using the GitHub Action](#option-2-using-github-action)\n- [File Structure](#file-structure)\n- [Disclaimer](#disclaimer)\n- [License](#license)\n- [Reference/Credits](#referencecredits)\n\n## Data Files\n- ‘sud’ files which are the raw downloaded file. This is a compressed file and therefore ideal for storing or sending of complete recordings.\n- ‘wav’ files containing the audio. This is a Microsoft WAV format file that can be opened by any media player, matlab, etc\n- ‘xml’ files contain metadata such as date recorded, gain setting, etc\n\n## Option 1. Using the Python Web App via Docker\n\u003cimg src=\"https://github.com/MichaelAkridge-NOAA/SUD2WAV/raw/main/docs/s01.png\" width=\"720\"/\u003e\n\u003cimg src=\"https://github.com/MichaelAkridge-NOAA/SUD2WAV/raw/main/docs/s07.png\" width=\"720\"/\u003e\n\n### Prerequisites\n- Docker / Docker Compose\n### Setup\n1. **Clone the repository:**\n\n    ```sh\n    git clone https://github.com/MichaelAkridge-NOAA/SUD2WAV.git\n    cd SUD2WAV\n    ```\n2. **Update Docker Compose File Volume Paths:**\n- Update input and output folder paths\n```\nservices:\n  sud_to_wav:\n    image: michaelakridge326/sud_to_wav_converter_app\n    ports:\n      - \"8501:8501\"\n    volumes:\n      - C:/UPDATE_THIS_FOLDER_PATH_input_sud_files:/workspace/input_sud_files\n      - C:/UPDATE_THIS_FOLDER_PATH_output_wav_files:/workspace/output_wav_files\n```\n3. **Pull Docker Image and run the Docker Compose File:**\n\n    ```sh\n    docker pull michaelakridge326/sud_to_wav_converter_app\n    docker-compose up\n    ```\n    This command will build the Docker image and start the Streamlit app.\n### Accessing the Web Application\n1. **Access the web application:**\n    Open your web browser and go to:\n    ```\n    http://localhost:8501\n    ```\n2. **Upload `.sud` files:**\n    - Click on the \"Browse files\" button and select the `.sud` files you want to convert.\n    - The selected files will be listed under \"Files to be processed\".\n3. **Convert files:**\n    - Click the \"Convert\" button to start the conversion process.\n    - The conversion output and any errors will be displayed in the web interface.\n4. **Check the output:**\n    - The converted `.wav` files will be saved in the `./output_wav_files` directory on your host machine.\n\u003cimg src=\"./docs/s03.png\" /\u003e\n\n## Option 2. Using GitHub Action\n1. Ensure your repository includes the GitHub Actions workflow file (`.github/workflows/convert.yml`):\n2. Under Repo Settings \u003e Actions \u003e General \u003e Workflow Permissions make sure they are set to \"Read and write\"\n3. Add your `.sud` files to the `input_sud_files` directory and push to the repository:\n    - When you push changes to the `main` branch or to the `input_sud_files` directory, the GitHub Actions workflow will be triggered to automatically convert the files.\n4. View the output branch\n    - The converted `.wav` files will be committed to a new branch named `output-\u003cdate_time\u003e` in your repository.\n\u003cimg src=\"https://github.com/MichaelAkridge-NOAA/SUD2WAV/raw/main/docs/s06.png\" align= 'right' /\u003e\n\u003cimg src=\"https://github.com/MichaelAkridge-NOAA/SUD2WAV/raw/main/docs/s05.png\" /\u003e\n\n## File Structure\n```\n├── docker-compose.yml\n├── README.md\n├── input_sud_files\n│   └── (place your .sud files here)\n├── output_wav_files\n│   └── (converted .wav files will be saved here)\n└── .github\n    └── workflows\n        └── convert.yml\n```\n----------\n#### Disclaimer\nThis repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project content is provided on an ‘as is’ basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or Department of Commerce bureaus stemming from the use of this GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.\n\n##### License\n- See the [LICENSE.md](/LICENSE.md) for details on this code\n- For x3 (lossless audio compression) packing and unpacking, see their [GPL-3.0 license](https://github.com/PAMGuard/x3/blob/main/LICENSE) for more details\n  \n##### Reference/Credits: \n- x3 Java Source: https://github.com/PAMGuard/x3\n  - Fork: https://github.com/MichaelAkridge-NOAA/x3\n- https://bioacoustics.stackexchange.com/questions/1258/soundtrap-sud-extracting\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelakridge-noaa%2Fsud2wav","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelakridge-noaa%2Fsud2wav","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelakridge-noaa%2Fsud2wav/lists"}