ipcam-view 
Android MJPEG video streaming made simple!
A wrapper library around the well known SimpleMjpegView and android-camera-axis projects.
If you have problem to identify your IpCam url, please follow this link
Features
- Default support by
android-camera-axis - Native support by
SimpleMjpegView - Handle credentials and cookies
- Multiple camera in one activity
- Snapshot
- Flip and rotate image
- Video recording
- Custom appearance
Gradle dependency
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
implementation 'com.github.niqdev:ipcam-view:<LATEST_RELEASE>'
}
Demo app
Usage
Add to your layout: example
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
// ADD THIS
xmlns:stream="http://schemas.android.com/apk/res-auto"
...>
<com.github.niqdev.mjpeg.MjpegSurfaceView
android:id="@+id/VIEW_NAME"
android:layout_width="match_parent"
android:layout_height="match_parent"
stream:type="stream_default OR stream_native" />
</RelativeLayout>
Read stream in your activity/fragment: example
int TIMEOUT = 5; //seconds
Mjpeg.newInstance()
.credential("USERNAME", "PASSWORD")
.open("IPCAM_URL.mjpg", TIMEOUT)
.subscribe(inputStream -> {
mjpegView.setSource(inputStream);
mjpegView.setDisplayMode(DisplayMode.BEST_FIT);
mjpegView.showFps(true);
});
Customize appearance
To get a transparent background for the surface itself (while stream is loading) as well as for the stream background
mjpegView.setTransparentBackground();
// OR
stream:transparentBackground="true"
To hide the MjpegView later, you might need to reset the transparency due to internal behaviour of applying transparency
mjpegView.resetTransparentBackground();
To set other colors than transparent, be aware that they will only be applied on a running stream i.e. you can't change the color of the surface itself which you will see while the stream is loading
Note that it only works when transparentBackground is not set to true and that you are not able to directly set transparent background color here
mjpegView.setCustomBackgroundColor(Color.DKGRAY);
// OR
stream:backgroundColor="@android:color/darker_gray"
To change the colors of the fps overlay
mjpegView.setFpsOverlayBackgroundColor(Color.DKGRAY);
mjpegView.setFpsOverlayTextColor(Color.WHITE);
To clear the last frame since the canvas keeps the current image even if you stop the stream, e.g. hide/show
mjpegView.clearStream();
To flip the image
mjpegView.flipHorizontal(true);
mjpegView.flipVertical(true);
To rotate the image
mjpegView.setRotate(90); // degrees
Apps that use this library
You are welcome to add your app to the list!
Development
Download Android NDK:
- manually
- in Android Studio: File > Other Settings > Default Project Structure > download NDK
Compile manually (verify your paths)
$ chmod a+x compileJni.sh
$ ./compileJni.sh
28.9k May 26, 2021
683 Nov 14, 2022
5.1k Dec 26, 2022
24 Nov 26, 2022
4.8k Dec 29, 2022
1k Mar 1, 2021
967 Nov 12, 2022
234 Dec 28, 2022
80 Dec 13, 2022
1.3k Jan 5, 2023
377 Jan 2, 2023
93 Dec 31, 2022
40 Oct 5, 2022
3 Nov 19, 2022
62 Dec 29, 2022
22 Dec 13, 2022
51 Jun 27, 2021
358 Dec 30, 2022
10 Sep 27, 2022