search

PkmX / lcamera

A camera app using the new camera2 API in Android Lollipop
1.28k stars 220 forks source link
android camera scala

readme

L Camera

Screenshot

L Camera is an open-source experimental camera app for Android L devices using the new android.hardware.camera2 API. Currently, the only supported device is Nexus 5 and Nexus 6 running Android 5.0 Lollipop.

Please note that this app is intended to test and study new features of the camera API, it is not for general uses as it lacks many basic camera features (location tagging, white balance, photo review, flash control, etc).

Features

Tour

Installation

You can either install the pre-built debug APK from the release page, or build and install the APK by yourself.

Usage

Just use it like any camera! Tap other four button at the bottom to bring up settings:

If you are looking for a stopwatch to test the burst capture feature, check out this jsfiddle.

After capturing, output files will be saved to the /sdcard/DCIM/Camera/ directory. Note that each DNG image is 15.36 MiB in size, so make sure you have plenty of free space available!

Working with DNG files

Most RAW post-processing programs should be able to open them. While Adobe Lightroom is probably the most popular RAW editor, both darktable (Linux, Mac) and RawTherapee (Windows, Linux, Mac) are both free alternatives that also offer very powerful editing capabilities.

A short DNG editing tutorial using RawTherapee.

60/120 FPS Recording

First, see pkmx/lcamera#4 about limitations of this modification. This modification is only available for Nexus 5.

To enable 60/120fps recording, the system library /system/lib/libmmcamera_imx179.so needs to be replaced with a modified version. The following is a simplified walkthrough of the process. Note that this is a very hacky solution and I'm not responsible for any damages done to your system or device. Approach at your own risk and make sure you understand what you are doing.

  1. You must have root access and busybox installed on your Nexus 5. (The latter is not strictly required, but makes the process easier as it provides install and killall.)
  2. Download the libmmcamera_imx179_lrx21o_60hz.so or `libmmcamera_imx179_lrx21o_120hz.so from the release page and transfer it to the device. (The following assumes that it is located in /sdcard/.)
  3. Launch a root shell.
  4. Make a backup of the original library first: cp /system/lib/libmmcamera_imx179.so /sdcard/libmmcamera_imx179_original.so
  5. Run mount -o remount,rw /system to re-mount the /system partition for read-write.
  6. Replace the library: install -m644 /sdcard/libmmcamera_imx179_lrx21o_60hz.so /system/lib/libmmcamera_imx179.so (Replace 60hz with 120hz if you downloaded the 120fps one.)
  7. Run mount -o remount,ro /system to re-mount /system as read-only again.
  8. Restart both the camera daemon and media server: killall mm-qcamera-daemon mediaserver

The camera should now be able to record at 60/120 fps and you can choose 60/120fps options in the settings menu on L Camera. All other camera apps will most likely be broken at this point. If you want to undo the modification, simply redo step 5~8 and copy the original library you backup-ed in step 4 instead.

For details about the library modification and a utility to patch your own, see contents of the libmmcamera_imx179_mod directory.

FAQ

Does it run on Nexus 4/7/10 or other phones that have received Lollipop update?

It seems that none of those devices fully support the new API as of now (2014/11/17). If you want to verify, run adb shell dumpsys media.camera with your device connected and developer mode enabled. You should see a dump of your device cameras' capabilities like this. Your camera's android.request.availableCapabilities must include MANUAL_SENSOR, MANUAL_POST_PROCESSING and RAW for L Camera to work.

Why do I get the 'Cannot parse package' error while installing?

Make sure the downloaded apk is not corrupted, as it seems some browsers download GitHub's webpage instead of the actual apk. You must also have the Lollipop running on your device.

Does it need root?

No. However, it is needed if you want to record videos at 60fps on the Nexus 5 as a system library needs to be modified.

Will you implement feature X?

Open an issue (one per feature please) on the tracker and I will see what I can do. However, the priority of development is investigating new ways to use the camera hardware rather than reimplement features that have been possible, or things that can be done in post-processing.

Hacking/Technical

The app is written in the Scala programming language and uses the following libraries/tools:

How to build

You must have both scala 2.11.5 and sbt >= 0.13 installed.

To build the app (the resulting APK will be placed in the bin/ directory):

$ sbt package

To build and run the app on device (assuming you have adb and developer mode enabled):

$ sbt run

Debugging

To see debug outputs, set allowed logging priority of lcamera tag to VERBOSE:

$ adb shell setprop log.tag.lcamera VERBOSE

Issues

Please report any bugs or feature requests on GitHub's issue tracker.

Credits

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.