Skip to content

sk33lz/bootstrap-html5-soundboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bootstrap HTML5 Soundboard

About

Flash Soundboards are a dying breed, so I wanted to make a soundboard boilerplate that will take soundboards into the next century using HTML5.

Bootstrap HTML5 Soundboard runs strictly on HTML5, jQuery, and CSS. No Flash is required!

Features

  • Plays HTML5 compatible audio files like M4A, MP3, OGG, and WAV.
  • Works in all modern browsers that support the HTML5 tag.
  • Responsive, mobile-friendly design works on mobile devices.
  • No need for Flash!

Installation

  1. Download the latest release from the Releases page.

  2. Unpack the archive to your web server or local machine.

  3. Add images in .png format that are 138px Wide and 120px High to the img folder for the best results.

  4. Add audio files in HTML5 <audio> tag compatible formats like .mp3, .m4a, .ogg, or .wav format to the audio folder.

  5. Ensure that the audio file and image files are the same name.

     Example:
     chewbacca.mp3
     chewbacca.png
    
  6. Edit the index.html and modify the source code with your file names.

  7. Edit the CSS class on the <audio> tag to have the same name as your file. This will ensure the JS sets up the proper unordered list rendering the image with the <audio> tag.

     Example:
     <audio class="chewbacca" title="Chewbacca Clip">
    

Using the Soundboard

  1. Open up the index.html file to view the soundboard.

  2. Click an image to play it's <audio> sound clip.

Adding Additional Sound Clips and Images

  1. Copy the last full <audio> tag lines and paste them below those lines to add another entry.

  2. Upload your new HTML5 compatible audio clip to the audio directory, 'audio'. (Formats: .m4a, .mp3, .ogg, .wav)

  3. Upload your new PNG image file to the the img directory, 'img'. (Formats: .png)

  4. Looking at the source code's index.html you would copy the following lines, Lines 84-88, and paste them on the following line, Line 89.

     <audio class="raven" title="Great Odin's Raven! Clip">
         <source src="audio/raven.mp3" />
         <source src="audio/raven.ogg" />
         <source src="audio/raven.wav" />
     </audio>
    
  5. Modify the <audio> title to what you would like users to see when they mouseover the image.

  6. Rinse and repeat these steps for additional soundboard entries with audio clips with images. Just make sure that your <audio> class name, your image name, and your <audio> src clip name match, or the jQuery won't work properly in rendering the soundboard.

Issues

Found an issue with this script? Please Submit an Issue on GitHub.

Feature Requests

Want to see something new in this script? Please Submit a Pull Request on GitHub. If it's something useful I will merge it into the codebase.

Learn More

Learn more about the Bootstrap HTML5 Soundboard on the Wiki page on GitHub.

Credits

  • The Bootstrap HTML5 Soundboard was inspired by Perry Harlock's HTML5 Soundboard.

  • The JavaScript used in this soundboard was found in this blog post.

  • The following audio files and image files included in this repository are copyright their original content creators and copyright owners. These files were included as examples of the types of audio files and image files that can be used in this HTML Soundboard script. These files are included for educational purposes and research only. They should fall under Fair Use.

About

HTML5 Soundboard powered by Bootstrap.

Resources

Stars

Watchers

Forks

Packages

No packages published