Videogular for AngularJS (1.x)
![Gitter](https://badges.gitter.im/Join Chat.svg)
Videogular is an HTML5 video player for AngularJS. Videogular is a wrapper over the HTML5 video tag, so you just could add whatever you want. This provides a very powerful, but simple to use solution, for everybody.
You could see a demo here: www.videogular.com
Angular (2+) Support
Videogular2 is under active development and will be available with Angular 2+. Videogular2 will follow the same philosophy and we're open to discuss any possibilities. If you want to contribute you can open a new issue with your suggestions or clone the repository to make pull requests.
You can find a demo here: https://videogular.github.io/videogular2-showroom/#/
And this is the development repository: https://github.com/videogular/videogular2
Why Videogular?
We're developing Videogular focusing on mobile devices and HTML5 video special capabilities. Videogular brings to you these key features:
- Bindable properties: Videogular's directives are bindable, just try the demo and play with bindings.
- Extendable through plugins: Thanks to our API you can develop your own plugins.
- Theme based: Customize it with your own themes and change between them on the fly.
- Native fullscreen support: Enjoy with native fullscreen support for Chrome, Firefox, Safari, iOS and Chrome for Android.
- Mobile support: Videogular can detect mobile devices to show/hide components in case that aren't supported. Also, you could use it in your responsive websites, Videogular will always scale to fit its container.
Documentation and how to install
** Important information:** Bower repositories have been deprecated. Now all modules are available inside the same npm package:
https://www.npmjs.com/package/videogular
Simply run npm install videogular
. Then import the desired features from the dist
directory.
See the Videogular's website for more info about how to start and installation notes (beware that this is presently out of date). We have also tutorials and examples if you need a guide or code samples.
For more info you can check the full Videogular API documentation.
Running and building
To run the project and create the minified and debug files just run grunt
.
This will run the tests and if everything works as expected it would create a build
folder on root.
Third-party plugins
If you have developed a Videogular's plugin or theme contact us through this form and we will add you to this list.
- Youtube plugin by NamPNQ
- Quiz plugin by NamPNQ
- Flash fallback plugin by NamPNQ
- Background video plugin by panurge-ws
- Videogular subtitle plugin (for Videogular 0.4.0) by farhan-repo
- Videogular Cuepoints plugin by HarryCutts (not to be confused with the later Cue Points feature)
Migrate to 2.0 from an older version of Videogular
Use of the videogular
package on NPM is now the preferred method of distribution. This now includes all of the features that had previously been distributed separately. Simply import the features that you desire into your build.
Migrate to 1.0 from an older version of Videogular
All attributes for the various directives (including plugins) are still being maintained as usual, however, the naming of several have changed significantly to conform to an improved coding style. Here is a semi-exhaustive list:
-
No more
<vg-video>
. Ditched in favor of<vg-media>
that supports audio as well. -
vg-controls
:vg-timedisplay -> vg-time-display vg-scrubBar -> vg-scrub-bar vg-scrubbarcurrenttime -> vg-scrub-bar-current-time vg-timedisplay -> vg-time-display vg-mutebutton -> vg-mute-button vg-volumebar -> vg-volume-bar
-
vg-poster-image -> vg-poster
For a complete migration guide we recommend you to check the Migration guide to Videogular 1.0.0.
Supported by
Videogular team would like to thank all of our generous sponsors who support this project:
Credits
Videogular is an open source project maintained by (literally) two fucking developers.
We want to thank all our contributors: Raúl Jiménez, Robert Zhang, Javier Tejero, Marcos González, Rafał Lindemann, Alberto Tafoya, Sergey Okhotnitski, Javier Cejudo, Sam Lau, paxal78, Raymond Klass, Harry Cutts, Chris MacPherson, stefanvonderkrone, Emil Ibatullin, Uzair Sajid, pavelnikolov, Frank3K, EmilioAiolfi, Bernhelm, Morriz, Chris Funk, Johann Beishline, edisonh, Nainterceptor, Max Maes, pire, Davin Kevin, bkuzma, VanVan, Kevin Feinberg, Jonathan Asquier, Centsent, Zane McCaig, Nils Thingvall, Tim Costa, Alex Wilde, jarrodlytle, daviddk , Artem Medvedev , super-ienien , Jared Fox and our bug submitters.
Changelog
Here you can see the complete changelog