HTML5 Goodness for Podcasting
Podlove Web Player is a Podcast-optimized, HTML5-based video and audio player with Flash fallback. It can be used as a WordPress plugin or within a static HTML/JavaScript context.
The Podlove Web Player supports almost every modern browser and also does captions, chapters and much more. Thanks to MediaElement.js for providing the foundation.
The release version should have the application, the moderator their dependencies and necessary styles and fonts
ready in the dist
folder.
Along with them there is a running example that shows you how to integrate the player in any webpage.
Either directly as in embed.html
or as an iframe/ embedded player as in index.html
.
Clone the repository and install all dependencies with
bower install
npm install
npm install -g gulp
Install autoprefixer to parse CSS and add vendor prefixes to rules fetched from 'Can I Use' https://github.com/ai/autoprefixer
sudo npm install --global autoprefixer
There is a gulp task for that, processing a version with line comments as well as a minified one
gulp styles
Make is now replaced by gulp
Just run the default task to build the distribution package to dist
folder.
gulp
npm install -g uglifyify minifyify
smallest possible code (>50kB)
browserify -g uglifyify js/app.js > static/podlove-web-player.js
with sourcemaps (~250kB)
browserify -d js/app.js | minifyify > static/podlove-web-player.js
Build, serve and watch the local repository version. With livereload on top
gulp serve
Some automated tests are written and can be found in the spec folder. Install PhantomJS to be able to run them on your machine.
Run them with
gulp test
Each commit pushed to the repo will automatically launch the tests on TravisCI.
Important! The Wordpress-plugin that includes the Podlove-Webplayer alone will be moved to its own repo.
Fork it
Create your feature branch
git checkout -b my-new-feature
Commit your changes
git commit -am 'Added some feature'
Push to the branch
git push origin my-new-feature
Create new Pull Request
git fetch
git checkout -b release origin/release
git merge origin/dev
gulp build
Force add all changes. Otherwise changes to the dist
folder would not be part
of the release.
git add dist -f
git commit "release <version-number>"
git push
Copy the commit messages from the merge commit to clipboard for later use.
git show HEAD^
Go to https://github.com/podlove/podlove-web-player/releases/new
Use as the tagname. Be sure to add a "v" to the beginning. Versions follow semantic versioning (for details see http://semver.org).
Find a (funny) name that can be easily remembered by humans.
Paste the contents of your clipboard into the description field and edit them to be a human readable changelog.
Hit the save button.
## Send feedback about the Podlove Web Player
Become a part of the
- Podlove community community.podlove.org, or discuss your
- Web Player topics or questions on community.podlove.org/c/podlove-web-player.
If you're interested in discussing podcasting topics in general, please visit sendegate.de.
- Podlove Project: podlove.github.com
- Web Player: docs.podlove.org/podlove-web-player
If you encounter a specific problem using the Podlove Web Player that you think is a bug, or you see a problem in the documentation, you can report the issue here:
github.com/podlove/podlove-web-player/issues
Also, if you have ideas for new features for player, please submit them as a Github issue.
Have a look on the Trello board to watch the status and progress of your issues:
trello.com/b/mFPdgi1P/podlove-web-player
For contributing to Podlove Web Player documentation, see:
github.com/podlove/podlove.github.com
Gerrit van Aaken, Simon Waldherr, Frank Hase, Eric Teubert, Juri Leino, Alexandra von Criegern and others
3.0.0-beta.3