|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Webcam Capture||2,109||315||21||a day ago||10||January 17, 2018||290||mit||Java|
|The goal of this project is to allow integrated or USB-connected webcams to be accessed directly from Java. Using provided libraries users are able to read camera images and detect motion. Main project consist of several sub projects - the root one, which contains required classes, build-in webcam driver compatible with Windows, Linux and Mac OS, which can stream images as fast as your camera can serve them (up to 50 FPS). Main project can be used standalone, but user is able to replace build-in driver with different one - such as OpenIMAJ, GStreamer, V4L4j, JMF, LTI-CIVIL, FMJ, etc.|
|Esp Who||1,404||a month ago||63||other||C|
|Face detection and recognition framework|
|Sony Pmca Re||1,394||7 months ago||138||mit||Python|
|Reverse Engineering Sony Digital Cameras|
|Deepdrive||745||a year ago||35||other||Python|
|Deepdrive is a simulator that allows anyone with a PC to push the state-of-the-art in self-driving|
|Akvcam||491||11 days ago||5||gpl-2.0||C|
|akvcam, virtual camera for Linux|
|Mediadevices||433||25||21 hours ago||61||August 24, 2022||60||mit||Go|
|Go implementation of the MediaDevices API.|
|Usb_cam||361||2 days ago||42||other||C++|
|A ROS Driver for V4L USB Cameras|
|Ps3eyedriver||237||4 years ago||23||other||C++|
|PS3EYE Camera Driver for OSX and Windows|
|Mipi_camera||181||2 months ago||121||C|
|Ps4eyecam||150||3 months ago||3||gpl-2.0||C|
|PlayStation 4 Camera driver implementation reference|
INDI 3rd party drivers include all the drivers not included by default in the INDI Core Library.
Check the Device Driver documentation for detailed information on how to operate each device driver.
All the driver documentation is community-contributed. Any updates or correction to the documentation in INDI library is greatly appreciated.
The following classes of devices are supported in the INDI 3rd party repository:
If a driver meets any of the following criteria, then it needs to be included in the INDI 3rd party repository:
Learn more about INDI:
Before building INDI 3rd party drivers. INDI Core Library must be already installed on your system.
sudo apt-get -y install libnova-dev libcfitsio-dev libusb-1.0-0-dev zlib1g-dev libgsl-dev build-essential cmake git libjpeg-dev libcurl4-gnutls-dev libtiff-dev libfftw3-dev libftdi-dev libgps-dev libraw-dev libdc1394-22-dev libgphoto2-dev libboost-dev libboost-regex-dev librtlsdr-dev liblimesuite-dev libftdi1-dev libavcodec-dev libavdevice-dev
You may also add libindi-dev if needed :
sudo apt-get -y install libindi-dev
mkdir -p ~/Projects cd ~/Projects
To build INDI in order to run drivers, then it is recommended to perform a quick shallow clone that will save lots of bandwidth and space:
git clone --depth=1 https://github.com/indilib/indi-3rdparty
On the other hand, if you plan to submit a PR or engage in INDI driver development, then getting a full clone is recommended:
git clone https://github.com/indilib/indi-3rdparty
Some of the drivers included in the INDI 3rd party repository require a library (usually made by the device manufacturer) to be installed before the driver can be built and installed. For example indi-qsi depends on libqsi, so libqsi must be built and installed before attempting to build and install the indi-qsi driver. Many of these libraries are included in the 3rd Party Repository and can be installed just like the drivers.
While you can build all the 3rd party drivers and libraries at once, it is typically recommended to build/install each 3rd party driver as required, since each 3rd party driver may have its own pre-requisites and requirements, and you probably don't need all the drivers. If you want build and install just one driver, please see this example of how to build INDI EQMod driver:
mkdir -p ~/Projects/build/indi-eqmod cd ~/Projects/build/indi-eqmod cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ~/Projects/indi-3rdparty/indi-eqmod make -j4 sudo make install
The complete list of system dependancies for all drivers on Debian / Ubuntu
sudo apt-get install libnova-dev libcfitsio-dev libusb-1.0-0-dev zlib1g-dev libgsl-dev build-essential cmake git libjpeg-dev libcurl4-gnutls-dev libtiff-dev libftdi-dev libgps-dev libraw-dev libdc1394-22-dev libgphoto2-dev libboost-dev libboost-regex-dev librtlsdr-dev liblimesuite-dev libftdi1-dev libgps-dev libavcodec-dev libavdevice-dev
You may also add libindi-dev if needed :
sudo apt-get -y install libindi-dev
You can build all the 3rd Party Libraries at once if you already have all of the requirements for each library installed. To install all the libraries, you would want to use the BUILD-LIBS build flag. If you want to build all 3rd Party drivers as described in the section below, you need to do this step first. You can use the following commands to install all the libraries:
mkdir -p ~/Projects/build/indi-3rdparty-libs cd ~/Projects/build/indi-3rdparty-libs cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug -DBUILD_LIBS=1 ~/Projects/indi-3rdparty make -j4 sudo make install
You can build all the 3rd Party Drivers at once if you already have all of the requirements for each driver installed. Before you attempt this, please make sure to install all the 3rd Party Libraries first. Please see the section above. After you have all the requirements, you can run the following commands to install all the drivers:
mkdir -p ~/Projects/build/indi-3rdparty cd ~/Projects/build/indi-3rdparty cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ~/Projects/indi-3rdparty make -j4 sudo make install
INDI uses Artistic Style to format all the C++ source files. Please make sure to apply the following astyle rules to any code that is submitted to INDI. On Linux, you can create ~/.astylerc file containing the following rules:
--style=allman --align-reference=name --indent-switches --indent-modifiers --indent-classes --pad-oper --indent-col1-comments --lineend=linux --max-code-length=124
Some IDEs (e.g. QtCreator) support automatic formatting for the code everytime you save the file to disk.
How to contribute to INDI full guide
Here is the short version on how to submit a PR:
If you would like to make cleaner PR (recommended!) please read this tutorial and follow it. The best way is to keep one logical change per commit and not pollute the history by multiple small fixes to the PR.
When submitting a new driver, the driver user documentation is required as part of the submission process.
Some binary files in this repository are dynamic libraries provided by various manufacturers and/or are built by various people who are volunteers.
The binary library files have install names that are then used when building and installing software on MacOS to properly link the libraries to the programs or to each other. The problem is that for various reasons, the install names sometimes are based on the build folders or install methods that those individuals used on their own computers and when the software is built by others, or built using different methods such as craft, the incorrect install names cause the linking to fail.
In addition, some of these libraries were built on computers that have other libraries those libraries depend on, such as libusb and opencv, and they have already been linked to these libraries in the locations on those people's computers. Often those links are to homebrew versions or to build folders on those people's computers and those libraries might not exist in those same locations on the craft binary server or computer on which someone is using this repository to build and install indi libraries.
Both of these issues would cause the libraries to fail to be installed and linked properly, even if it appears to have succeeded.
This will cause them to not function correctly and possibly cause crashes of INDI or KStars.
Often the issue would not be revealed until the packaging step or even when someone tries to use the drivers.
The Fix MacOS Libraries Macro will try to detect both of these issues and if it finds a problem, it will cause a fatal error. This way, the issue will get flagged so that the managers of this repository will be alerted to the issue either by people who use this repository or by the craft binary server. If this happens to you, please report the issue as soon as possible so that the repository can be updated.
The FIX_MACOS_LIBS option can be enabled to fix the problems immediately when they are detected. If you enable this option, the build will continue after the problem is fixed so you can fully build the software. If you have the rights to update the INDI 3rd Party Repository, please fix the problem by just doing a commit and pushing the changes the script made to the libraries. If not, again, please report the problem. This build option cannot be enabled on the craft binary server because it will leave the repository on the server in a modified state and the next time the 3rd Party Repository gets modified, it will fail to do a "git pull" due to the modifications.
In order to run the unit test suite you must first install the Google Test Framework. You will need to build and install this from source code as Google does not recommend package managers for distributing distros.(This is because each build system is often unique and a one size fits all aproach does not work well).
Once you have the Google Test Framework installed follow this alternative build sequence:-
cd ~/Projects/build/indi-3rdparty cmake -DINDI_BUILD_UNITTESTS=ON -DCMAKE_BUILD_TYPE=Debug ~/Projects/indi-3rdparty make -j4 cd test ctest -V