https://github.com/bitplan/com.bitplan.mjpegstreamer
Java library for handing MJPEG streams - can e.g. display stream as a preview
https://github.com/bitplan/com.bitplan.mjpegstreamer
bitplan handing-mjpeg-streams java-library mjpeg mjpeg-stream webcam-capture webcam-streaming webcam-viewer
Last synced: about 1 year ago
JSON representation
Java library for handing MJPEG streams - can e.g. display stream as a preview
- Host: GitHub
- URL: https://github.com/bitplan/com.bitplan.mjpegstreamer
- Owner: BITPlan
- License: apache-2.0
- Created: 2016-08-25T16:10:45.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2020-01-23T09:49:02.000Z (over 6 years ago)
- Last Synced: 2025-04-05T00:41:16.223Z (about 1 year ago)
- Topics: bitplan, handing-mjpeg-streams, java-library, mjpeg, mjpeg-stream, webcam-capture, webcam-streaming, webcam-viewer
- Language: Java
- Size: 12.8 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### com.bitplan.mjpegstreamer
[Java library for handing MJPEG streams - can e.g. display stream from a Webcam as a preview](http://www.bitplan.com/MJpegStreamer)
[](https://travis-ci.org/BITPlan/com.bitplan.mjpegstreamer)
[](https://search.maven.org/artifact/com.bitplan/com.bitplan.mjpegstreamer/0.0.7/jar)
[](https://github.com/BITPlan/com.bitplan.mjpegstreamer/issues)
[](https://github.com/BITPlan/com.bitplan.mjpegstreamer/issues/?q=is%3Aissue+is%3Aclosed)
[](https://www.apache.org/licenses/LICENSE-2.0)
[](http://www.bitplan.com)
### Documentation
* [Wiki](http://www.bitplan.com/MJpegStreamer)
* [com.bitplan.mjpegstreamer Project pages](https://BITPlan.github.io/com.bitplan.mjpegstreamer)
* [Javadoc](https://BITPlan.github.io/com.bitplan.mjpegstreamer/apidocs/index.html)
* [Test-Report](https://BITPlan.github.io/com.bitplan.mjpegstreamer/surefire-report.html)
### Maven dependency
Maven dependency
```xml
com.bitplan
com.bitplan.mjpegstreamer
0.0.7
```
[Current release at repo1.maven.org](http://repo1.maven.org/maven2/com/bitplan/com.bitplan.mjpegstreamer/0.0.7/)
### How to build
```
git clone https://github.com/BITPlan/com.bitplan.mjpegstreamer
cd com.bitplan.mjpegstreamer
mvn install
```
## Links
* https://en.wikipedia.org/wiki/Motion_JPEG
## Screenshot

## Usage
```
java -jar mjpegstreamer.jar --help
Help
MJpegViewer Version: 0.0.6
github: https://github.com/BITPlan/com.bitplan.mjpegstreamer
usage: java com.bitplan.mjpegstreamer.MJpegViewer
-ac (--autoclose) : auto close
close when stream is finished
-d (--debug) : debug
adds debugging output
-h (--help) : help
show this usage
-o (--overlay) : adds a rectangle overlay
-r (--rotation) N : rotation e.g. 0/90/180/270 degrees
-rto (--readtimeout) N : readtimeout in milliseconds
default is 5000 millisecs
-s (--start) : auto start
start streaming immediately
-t (--title) VAL : title
title to be used
-u (--url) VAL : url
url to be used
-v (--version) : showVersion
show current version if this switch is used
```
## Examples
java -jar mjpegstreamer.jar --url http://iris.not.iac.es/axis-cgi/mjpg/video.cgi?resolution=640x480 --start --title "NORDIC Telescope on Observatorio del Roque de Los Muchachos - La Palma"

java -jar mjpegstreamer.jar --url http://87.139.217.70/mjpg/video.mjpg?resolution=640x480 --start --title "Dollnstein/Germany"

see http://www.insecam.org for more publicly accessible test cameras
### gphoto2 stream e.g. for Canon EOS Preview
gphoto2 --capture-movie --stdout | java -jar mjpegstreamer.jar -u - --start --title "Canon EOS preview"

see preview script for more details on how to handle the release of the USB port which might be blocked by the PTPCamera process on MacOSX
## Installation
```
git clone https://github.com/BITPlan/com.bitplan.mjpegstreamer
mvn install
```
to use as a library
```
mvn clean compile assembly:single
```
to create a stand alone jar
## Version history
* 0.0.1: 2013 Internal Project at BITPlan
* 0.0.3: 2016-08-25 Released as Open Source Project
* 0.0.6: 2018-08-03 version number upgrade
* 0.0.7: 2081-08-22 upgrades to Java 8 and uses com.bitplan.pom