0
0
mirror of https://github.com/mediathekview/zapp.git synced 2024-09-20 04:12:14 +02:00
zapp/README.md

63 lines
2.5 KiB
Markdown
Raw Normal View History

2016-09-16 12:10:36 +02:00
# ZAPP
2016-10-13 17:26:49 +02:00
1. [About](#about)
2. [FAQ](#faq)
3. [Libraries Example](#libraries)
## About
2016-09-16 12:10:36 +02:00
Zapp gives you easy access to a large number of German public broadcasting live streams. Watch ARD, ZDF and other channels live. Zapp makes it easy to quickly switch between channels.
![ZAPP logo](app/src/main/res/mipmap-xxxhdpi/ic_launcher.png)
2017-03-27 17:20:39 +02:00
<a href="https://f-droid.org/repository/browse/?fdid=de.christinecoenen.code.zapp" target="_blank">
<img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="80"/></a>
2016-10-12 14:15:07 +02:00
---------------------
## FAQ
### The videos do not play, what should I do?
The are multiple reasons why the streams won't play on Android:
- Maybe you are using Zapp outside of Germany. Some channels may block access
to their streams or to single shows for users outside of Germany. When in doubt
head the the channels website (using a desktop) and check out the live stream
there. If you get an error message about **geoblocking** there, Zapp can't do
anything about it right now.
- Maybe your internet connection is wonky or blocked by a firewall.
- Maybe you Android device can't handle the video codec. You can share the
stream to another video player by pressing the menu button after selecting a
channel. Click "Teilen" and let Google Video Player open the stream. If Google
Video Player is not able to play back the stream your device most likely cannot
handle the video format.
2016-10-13 17:12:02 +02:00
### Why don't I see any show info for a specific channel?
2016-10-12 14:15:07 +02:00
Most channels don't have any public API to get EPG data from. So Zapp tries to
parse channel websites for the shows currently running. This approach is not
very reliable and may break whenever the websites change or update.
### Why are there channels missing, like RTL or Pro7?
Zapp does only stream public broadcasting channels. Channels like RTL and Pro7
are owned by private companies and are not allowed to be streamed without paying
for them.
2016-10-13 17:26:49 +02:00
---------------------
## Libraries
Zapp uses a lot of awesome open source libraries:
- [JUnit](http://junit.org/junit4/) to test things out
- [Gson](https://github.com/google/gson) to parse the list of channels
- [Commons IO](https://commons.apache.org/proper/commons-io/) for a sane way to handle files on Android
- [Paperboy](https://github.com/porokoro/paperboy) to easily display a nice looking changelog
- [DragListView](https://github.com/woxblom/DragListView) to let you reorder the channel list intuitively
- [Butterknive](https://jakewharton.github.io/butterknife/) to avoid writing a lot of boilerplate code