Skip to content
Titanium Image Gallery for iPhone and iPad
JavaScript Objective-C Python Java
Find file
New pull request
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Titanium Image Gallery

Example implementation of an Image Gallery for Titanium Mobile. It runs on iOS and Android platforms.

Created by:

Use as a Titanium module

Install the module

  1. Run Module/ios/imagegallery/ or ant Module/android/imagegallery which creates your distribution or click Downloads and select your download
  2. cd to /Library/Application Support/Titanium
  3. copy this zip file into the folder of your Titanium SDK

Register the module

Register your module with your application by editing tiapp.xml and adding your module. Example:

    <module version="{VERSION_NUMBER}" platform="iphone">com.codeboxed.imagegallery</module>
    <module version="{VERSION_NUMBER}" platform="android">com.codeboxed.imagegallery</module>

When you run your project, the compiler will know automatically compile in your module dependencies and copy appropriate image assets into the application.

Use the module

// Import ImageGallery module
var ImageGallery = require('com.codeboxed.imagegallery');

var win = Ti.UI.currentWindow;

// Array with image objects
var imagesArray = [
    {path:'1.jpg', caption:'Kitten 1'},
    {path:'2.jpg', caption:'Kitten 2'}

// Initialize the Image Gallery
var imageGallery = ImageGallery.create({
    images: imagesArray,
    columns: 4, // Set the numbers of columns (optional). Default is 4
    thumbSize: 75, // Set the thumb image size (optional). Default is 75
    thumbPadding: 5 // Set the thumb image padding (optional). Default is 5 

// Add it to the current window


  • For an example on how to integrate the modules, check the Titanium mobile project included in the repo.
  • If you have any suggestions or bug reports, open a GitHub Issue.
  • If you have in mind any fixes/improvements, please feel free to contribute to the project.
  • Android is not supported any longer. It works with 1.6.x and hopefully will be supported again in the future.
Something went wrong with that request. Please try again.