ludolphus/ti.ios.trim

A module for trimming and compressing videos with Appcelerator Titanium.

---

This project is not actively maintained. Proceed at your own risk!

(If you're willing to take over, please leave a message at #5)

---

ti.ios.trim Module

Description

This module extends the Appcelerator Titanium Mobile framework and allows trimming and compressing videos on iOS. This is currently not possible using Titanium's VideoPlayer:

[#TIMOB-1816] iOS: Phone > Record Video, edit/trimming is not shown in playback - Appcelerator JIRA [#TIMOB-4200] iOS - Edit mode on record video returns entire video - Appcelerator JIRA

Getting the module

Find the newest version in the dist folder.

Referencing the module

Simply add the following lines to your tiapp.xml file:

<modules>
    <module platform="iphone" version="0.2">ti.ios.trim</module>
</modules>

Accessing the module

To access this module from JavaScript, you would do the following:

var trimmer = require('ti.ios.trim');

The trimmer variable is a reference to the Module object. a

Reference

trimVideo({Object} options)

options can have the following keys:

• input
  • the path to video file to be trimmed
  • this has to be either an absolute file path (via file.resolve()) or a path to an object inside the asset library (e.g. using the TiAssetsLibrary Module)
• quality (optional)
  • the quality of the output video (1 = low, 2 = medium, 3 = high)
  • as an orientation: the example .mp4 file has a size of 15.3 MB and the output file (no trimming, only compression) sizes are the following: 1.12 MB (low), 6.12 MB (medium), 15.26 (high)
• startTime (optional, default: 0)
  • beginning of the trimmed movie (in seconds)
• endTime (optional, default: duration of the video file)
  • end of the trimmed movie (in seconds)
• success
  • callback to be invoked after successful trimming
  • the callback is passed an object that has the following properties:
    • thumbnail: the thumbnail of the video as an image blob
    • videoURL: the path to the trimmed video file
• error
  • callback to be invoked in case of an error

var inputFile = Ti.Filesystem.getFile('path/to/videoFile');
trimmer.trimVideo({
    input: inputFile.resolve(),
    quality: 1,
    startTime: 0,
    endTime: 10,
    success: function(e) {
        Ti.API.info('SUCCESS:');
        Ti.API.info('path to trimmed file: '+ e.videoURL);
    },
    error: function(e) {
        Ti.API.error('ERROR:');
        Ti.API.info(JSON.stringify(e));
    }
});

Changelog

• 0.3:
  • adds the thumbnail of the trimmed video to the success callback
• 0.2:
  • adds an optional quality parameter to compress videos
  • adds support for video files inside the asset library
  • makes startTime and endTime optional
• 0.1: Initial version

Author

Martin Tietz web: http://www.martin-tietz.com email: [email protected]

License

Copyright (c) 2013 Martin Tietz

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.