Skip to content
@orcasound

Orcasound

Listen for whales! Open source bioacoustic tools aimed at saving endangered orcas (Southern Resident Killer Whales)

Ahoy! This is Orcasound 👋

Our most-inspirational image of the orcas we're trying to help save: a single fin being watched by many riders from the decks of a Washington State ferry.

Our Voyage Thus Far 🧭

Since an Orcasound Kickstarter in 2017, we have been building open source software here on Github to help save the endangered orcas that seek salmon along the west coast of North America. Experiencing the live sounds of wild killer whales and acting to help conserve them is at the 💗 heart of our collective collaboration.

We began with the challenge of building an end-to-end audio live-streaming solution to make it easy to listen for whales through the Orcasound network of underwater microphones ("hydrophones") in orca habitat. The orcanode repo generates the audio data streams and the orcasite repo provides a web app for playback that "just works" in any browser and scales efficiently.

From the beginning, we have benefited greatly from the amazing all-volunteer hackathon community -- mainly through the organizational efforts of DemocracyLab and Microsoft Garage -- both through in-person events in/near Seattle (Washington, USA) as well as many virtual events during the COVID pandemic. Both Microsoft's AI for Earth program and Amazon Activate have supported our efforts with grants and/or cloud service credits. In 2020-22, we benefited from Google Summer of Code contributors in the orcagsoc repo and in 2023 Amazon sponsored our data storage/egress via Orcasound in Amazon's Open Data Registry.

On the Horizon (Updated Feb 2023) 🗺️

See what's next on Orcasound's public road map. You can also suggest or vote up features! As of 2023, you can join top-level discussions and help manage overarching projects in our oranizational repo.

Our long-term motivation is to make the Orcasound web app and our other open source projects into a more-and-more effective suite of free conservation tools. Along the way, we are trying to be as open, sharing, modular, and foresightful as possible in the hope that what we build for orcas will help bioacousticans and conservationists study and save other soniferous species around the planet.

Welcome Aboard! 🛳️

Would you like to help save the orcas and contribute to open source software?

The Orcasound organization on Github has a growing number of projects to which you can contribute. We welcome coders (front/back-end or full stack developers, bioacousticians, data scientists) and designers (UXers and other creatives), as well as project managers, mentors, and hardware engineers. The Orcasound community is super-friendly, daily communication mainly happens on Slack (you're invited!), and there are weekly virtual meetings where you can introduce yourself and hear what others are doing.

Here is the Current Volunteer Handbook where you can find more info about Orcasound's motivations, code of conduct, and high-priority projects.

See below for how you can join the Orcasound community and start contributing right away!

  • Developers

    • If you're interested in contributing code, we would welcome your input on any of our projects listed in the Current Volunteer Handbook. If you are interested in making a contribution to any of the listed projects, or would like to make a bigger commitment to Orcasound long-term, go ahead and introduce yourself in Orcasound's U#dev-general Slack channel!

    • Active Github repositories for our high-priority 2023 projects are orcasite for the live listening app and human detections, orcanode for the hydrophone network's audio streaming software (running on Raspberry Pis), aifororcas-livesystem for the OrcaHello AI system that auto-detects sounds, orcamap-react for mapping and analyzing SRKW location data, and orca-shipnoise for monitoring underwater noise pollution from large vessels that can interfere with orca communication. Please see each repo's CONTRIBUTING.md document for details!

  • Product and UX Team

    • We have an incredible team made up of Product Managers, UX Researchers, UX Designers, Content Strategy folks, UX Writers, and more! We highly encourage a culture of professional learning and growth fueled by mentorship and learning by doing. If you're interested in volunteering as a Product and UX Team member:
  • Data Scientists

    • If you're interested in machine learning you can access Orcasound's open data -- raw live/archived audio and labeled recordings -- and peruse deployed project summaries at ai4orcas.net

    • How to download the training and testing data for ML models?
      • Find what you want in the wiki and then Access data via AWS CLI
      • If you have not used AWS CLI before, or if you want to learn more about the available buckets, proceed here to read a high-level summery of the AWS buckets.
      • A subset of Orcasound’s open labeled data includes data archives that were prepared via the Pod.Cast system. The Pod.Cast data archive wiki page provides instructions on how to download Pod.Cast data. This is a good place to start if you want to take a look at the labeled data.
      • If you want a Python script to handle the data download, download_datasets.py will get you started.
    • How to find the code for the latest model?

🤫 Psst! You can create your own organization README and include emojis using this (cheatsheet](https://www.webfx.com/tools/emoji-cheat-sheet/).

*

Google Summer of Code Prospective Contributors

If you're a prospective Google Summer of Code contributor, don't miss Orcasound's GSoC project page and open source advice from Orcasound's past GSoC participants!

Pinned

  1. orcadata orcadata Public

    Development of bioacoustic tools for analyzing Orcasound data -- either post-processing of archived raw FLAC files or real-time analysis of the lossy stream and/or FLAC files.

    Jupyter Notebook 53 23

  2. orcanode orcanode Public

    Software for live-streaming and recording lossy (AAC) or lossless compressed audio (HLS, DASH, FLAC) via AWS S3 buckets. ⭐

    C 32 12

  3. orcasite orcasite Public

    Live-listening web app -- http://live.orcasound.net ⭐

    Elixir 42 47

  4. orcamap-react orcamap-react Public

    ReactJS version of Orcamap (current version of orcamap project)

    TypeScript 23 34

  5. aifororcas-livesystem aifororcas-livesystem Public

    Real-time AI-assisted killer whale notification system (model and moderator portal) ⭐

    C# 35 20

  6. product product Public

    Repository for the Orcasound UX Team to communicate, receive project briefs, and prepare designs to be handed off to production

    4

Repositories

Showing 10 of 46 repositories