Open Audio Weekend
Welcome to the repo for Open Audio Weekend, hosted at The New York Public Library, June 25-26, 2016. This document contains materials and logistics for orienting participants to our 2 days of prototyping, creating, and sharing new approaches to audio accessibility for the public good.
The organizing team is grateful for the group of talented and engaged community members who brought together a diverse and impressive set of skills to make this weekend a success. To read more about the projects and prototypes conceived during the event, please visit our Projects page.
Table of Contents
- Open Audio Weekend Code of Conduct
- Slack & Social Media
- New to Git or Github?
- Sharing Your Project
- Documentation Policy
Open Audio Weekend is being held in the Celeste Bartos Forum of The New York Public Library's central branch, the Stephen A. Schwarzman Building. The Celeste Bartos Forum is on the ground floor of the library and is accessable through the Library entrance on 42nd Street. This entrance is wheelchair accessible. Upon entering at 42nd Street, the forum is directly opposite this entrance.
At the start of both Saturday and Sunday, event volunteers will be stationed outside the entrance of the forum and available for questions. Throughout the event, staff and volunteers will be available to attendees.
|Saturday, June 25th|
|10:00 AM||Registration & coffee|
|10:30 AM||Introductions & agenda for the day|
|11:30 AM||Group working session|
|1:00 PM||Lunch provided|
|2:00 PM||Group working session|
|5:00 PM||Day 1 ends|
|Sunday, June 26th|
|10:00 AM||Day 2 begins, coffee, group working session|
|1:00 PM||Lunch provided|
|2:00 PM||Final group working session, prepare for shareout|
|4:00 PM||Final shareout|
|5:30 PM||Open Audio Weekend ends|
This is a big topic with a lot to discuss and discover. If you're interested in continuing conversation, collaboration, and creation beyond the hosted hours, here are a few suggested spots close to the Library.
- Bryant Park: The Library's backyard with free wifi to boot.
- Southwest Porch: Located in Bryan Park this bar serves food and free wifi.
- Slattery’s Midtown Pub: a local bar serving food and wifi.
Open Audio Weekend Code of Conduct
In order to foster a productive and welcoming environment for this hackathon, we request that all participants read the NYPL Rules & Regulations document, which will serve as the code of conduct for the event.
As you know, Open Audio Weekend is a two-day hackathon to make audio accessible for the public good. It’s a big challenge to tackle so we’ve compiled some prompts to stimulate conversations and project ideas!
- Discover: What new experiences can we make around discovery of audio?
- Find: How can we make it easier to search audio?
- Listen: What are some meaningful ways we can augment the experience of listening to audio?
- Share: How can we make it easier to share audio?
- Learn: What can we learn from audio? How can audio be used in an educational context?
- Engage: How can we engage a community through audio?
- Access: How can we make audio collections more usable for people with disabilities?
Information regarding how to obtain audio and transcripts provided by the Open Audio Weekend partners can be found in the Materials section.
Speech Recognition, Speech To Text, Transcripts
- CMUSphinx - a group of open-source speech recognition systems developed at Carnegie Mellon University.
- Kaldi - a toolkit for speech recognition written in C++ and licensed under the Apache License v2.0
- p2fa-vislab - A script for audio/transcript alignment written in Python.
- Gentle - Robust yet lenient forced-aligner built on Kaldi. A tool for aligning speech with text.
- Open Transcript Editor - an open-source, self-hosted, web-based tool for correcting transcripts that were automatically generated using speech-to-text software via auto-transcription services such as Pop Up Archive. It is being developed by NYPL Labs in partnership with The Moth and Pop Up Archive with generous support from the Knight Foundation. Example implementations can be found at:
- Praat - a free scientific computer software package for the analysis of speech in phonetics
- Sonic Visualiser - a free application for viewing and analyzing the contents of audio files
- WaveSurfer - a free audio editor widely used for studies of acoustic phonetics
Audio Manipulation, Converters
- FFmpeg - a free software project that produces libraries and programs for handling multimedia data
- Audacity - A free multi-track audio editor and recorder
- VLC media player - open source cross-platform multimedia player; useful for media file conversion (e.g. mp3 -> wav)
- Pydub - Manipulate audio with python
- Audio clipping tool. "Give us an audio file, an image, and some timestamped text and we'll give you a brief video that you can download or tweet." part of the Audiosear.ch API cookbook.
Audio Synthesis, Programming
- Csound - a computer programming language for sound
- ChucK - a concurrent, strongly timed audio programming language for real-time synthesis, composition, and performance
- Pure Data - a visual programming language for creating interactive computer music and multimedia works
- SuperCollider - an environment and programming language for real-time audio synthesis and algorithmic composition
- FluidSynth - a free open source software synthesizer
- Timbre.js - a functional processing and synthesizing audio for the web
- Audiosear.ch API - Full text search & recommendation API for podcasts and radio. Free API is also available.
- WebAIM: Web Accessibility in Mind - Website with a number of excellent resources and services around web accessibility many of which are highlighted in the Resources Page.
Slack & Social Media
We’ve set up an instance of Slack for use during the event. For those of you not familiar with Slack, it’s a chatroom allowing group and 1-on-1 conversations. To use the event Slack, just log in at: togetherwelisten.nypl.org/openaudio/talk.
The hashtag for our event is #openaudio. Please use it to tag your tweets, Instagrams & other posts related to the event!
New to Git or Github?
Git is a file control system that lets people share and contribute to projects (called “repositories”), most of them software projects (but some people use it for other things, like taco recipes). Github (the website you are on now) is a company that allows anyone to host public Git projects for free.
We will use Git and Github to share the projects made during the Open Audio Weekend. If you're not a programmer, don't worry, sharing files in Github is as easy as dragging and dropping files to your browser! For a quick introduction on creating and updating a repository on Github, read the Creating a Repository (make sure the repository you create is Public), Adding a File to a Repository, and Editing Files in your Repository tutorials. There are more examples in the Github help. There is also this great introductory tutorial on how to become an open-source software contributor via Github by Ashley Blewer.
Event volunteers will be on hand during the event to help out.
IMPORTANT: All code you submit in the Open Audio Weekend should go to repositories you create in the OpenAudio Organization. Make sure your repositories are public.
Sharing Your Project
Every team will present their project at the end of Day 2. As described above, every project will have its own repository.
- Make sure your project includes a README: select “Initialize this repository with a README” when creating the repository and then edit the file or just add a
README.mdfile later (it is just a regular text file with the
.mdfile extension instead of
- Add this information to your README: project name, team members, project description, and links to all external assets (those outside of the repository). Make sure to take advantage of Github's text formatting toolbar.
- If your project is an app (web or otherwise), make sure to include screenshots.
- Depending on your type of project you may add additional files so you can present and share your project. Ask any of the volunteers if you have any questions on how to use Github.
During the final shareout you will use this repository and README as launchpad for your presentation. All projects will be presented from the same computer which will be connected to the projector so make sure to have all the necessary links in there!
Participants of this event may be photographed or filmed for educational and promotional purposes. Please notify staff if you do not wish to be photographed or filmed.