photo / mobile-ios

Trovebox mobile application for iOS

[](https://gitter.im/photo/mobile-ios?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

What is Trovebox?

1. FAQ, Answers to the most common questions.
2. API, Documentation to get started building applications on Trovebox.
3. Schemas, Description of what the different objects in Trovebox look like (i.e. a photo or a comment).
4. Guides, Detailed guides to help you get the Trovebox software installed on various systems.

---

How does Trovebox work?

Trovebox works similarly to Flickr, Smugmug and other photo sharing services with one major difference: you retain ownership and give Trovebox access to use them. All photos, tags and comments are stored in your personal cloud accounts with companies like Amazon, Rackspace or Google. This means you can easily switch between Trovebox services, use more than one at a time or stop using them altogether while retaining all of your photos, tags and comments.

---

Why should I use Trovebox?

While Trovebox functions like many existing services it's drastically different for several reasons.

1. Ownership Users can specify where their photos are stored. By default they are seamlessly stored in your Amazon S3 bucket.
2. Built in backups Since you upload photos to your own Amazon S3 bucket it's like uploading and archiving your photos in one step.
3. Portability Easily start off by signing up for a hosted Trovebox account and later switch to hosting the software yourself. There's no need to transfer your photos somewhere else since it's federated. It's like plug and play.
4. Durability Your photos are not tied to any particular photo service. Because everything is open you can write your own web interface for your photos, choose between Trovebox hosting providers or install the Trovebox software on your own server.
5. Community New features will be entirely community driven. Features with the most votes will get top priority in getting implemented. If you want a feature that doesn't have many votes you can implement it yourself and issue a pull request.

---

What if I use Flickr or Smugmug?

If you're using Flickr or Smugmug you should consider switching to Trovebox. The more photos and time you invest on a proprietary photo sharing service the more devastated you're going to be once they shut down or no longer appeal to you.

There are importing tools available to make the switch easy.

---

DEVELOPERS

Requirements

CocoaPods, more information on: http://cocoapods.org

Localization

Use this command to run in all files .m and generate the translation file to be filled by translators.

cd Trovebox
find . -name \*.m | xargs genstrings -o en.lproj

Missing implementation

After download our code, Xcode will complain that a PrivateAuthenticationService.m is missing. This happens because it is the implementation applied by Trovebox. You can download it here. It will be an empty implementation. Then to connect to your service use the OAuth Procedure. Click in Login with email > Own Server

mobile-ios's Issues

Asynchronous photo uploads

This maybe addressed by UIProgressView in #33 but the user should be able to start a photo upload and continue using the app. Perhaps they will take another photo and upload that one too both in parallel.

Set private to "off" by default

The privacy setting should be the same across apps, set to public by default.

When selecting a TAG getting message

When clicked in Tags user receives a list of tag. If the user select one tag, he will receive a message "Internet Error".

Freeform tag entry when uploading photo

When uploading a photo you should be able to type a new tag in addition to selecting from the list

CORE: Webservices classes

Create classes to hold all webservices code:

WebService.[hm]
WebServiceInvoker.[hm]

Apple id devices

Add some devices from the test flight that are not in apple's developer website.

GALLERY: Social

Click on the picture and share it in Facebook, twitter or email.

Check message 401 and 403

Changes on OAuth

Can we try to implement our OAuth flow the way Google does?
http://code.google.com/apis/accounts/docs/OAuth_ref.html#SigningOAuth

Basically, you use 'anonymous' for the consumer key and secret. This will require a couple changes.

• When first sending the user to OpenPhoto you will need to request an oauth_token using 'anonymous' for the key and secret.
• You will need to pass the oauth_token value that is returned from that call in the URL the user is redirected to in the browser.
• When the user is directed back to the OpenPhoto app you will only receive oauth_consumer_key and oauth_consumer_secret.
• Store these values and continue to pass 'anonymous' for the application key and secret.

Internet check

Check if the user has network to request that from server

GALLERY: Title and description

Add title and description when a user clicks an image

PICTURE: Aviary

Add effects from Aviary. Really simple.

PICTURE: Bug found by Jaisen

Fix a bug that Jaisen found in the demo to upload pictures

Tabbar icons with @2x resolution

Clean up warning project

PICTURE: Size

Add a functionality to reduce the size of the picture. Today it is too large and takes a lot of time.

• the user will be able to use to send the high resolution picture

SETTINGS: to be defined

to be defined

Look into implementing TestFlight checkpoints

Remove workaround for BrowserID bug

We should remove the "mobile passphrase" and use the BrowserID authentication.

PICTURE: Tags

Add tags to photo

upgrade json to the latest version

Today the version being used in the app is from google source.

We should just update to the latest version found in github:
https://github.com/stig/json-framework

Add GPS position

Add gps position when uploading new pictures. User must agree with it.

HOME: Creation animation

What we have to do:

• Get URL of 25 images. (part of my refactoring)
• Random 3 images
• make an effect with the 3 images of magnify and fade out/in on them.
• should be simple using UIImage animation.

iPad like app

Make the app available for iPad.

Provide list of sites being used by testers

Home pictures crash

NSUserDefaults is not thread safe. When the user refreshes the pictures, it may crash. Choose another solution.

BrowserID bug when login iOS 5 Safari

BrowserID redirects the user to an empty page.

TAGS: Implementation

• change the UINavigation style. I didn't figure out.
• get the tags from the website . (part of my refactoring)
• show how many pictures each tag has
• show the pictures from that tag
• share the picture with Facebook, twitter and email.

Update all frameworks code

Internet Reachable false message

I received a message for the home screen saying that there was no internet. Probably because at this point, the validation didn't run yet.

Solution: make WebService.[h/m] singleton and invoke the check in the beginning of the application (OpenPhotoAppDelegate)

Log out button

Add logout button int the tab bar item on settings.

After uploading a photo user should go to gallery page

Currently the user is directed to the home screen after an upload.

Tag not submitted properly

When submitting tags it should be a comma delimited list. It looks like what is being passed in is a json string.

tags=patrick,jaisen

Looks like right now it is (this is incorrect).

tags=['patrick','jaisen']

Authentication

Add authentication Oauth to the app

PICTURE: Navigation

Add a button Cancel in the navigation where we are adding details.

Check app on iOS 5

Integrate TestFlight SDK

With TestFlight SDK integrated to the application we can have much more details of crash, checkpoints and a better feedback.

Account setup

WOW... Not even going to test this app as I know for a fact I will never use it because the registration process is long and tedious. If you want this app to be successful you need to remove amazon registration and just create a global key for your application and use that.

Also you need to add a link that makes it easier to register on the main page. Maybe a box that says put in what account you want then it goes to that url.

I gave up half way through because it was taking to long and I didn't feel like registering with amazon.

Adding UIProgressView

Today the upload is using the OAuth framework to send the data. We may have to change to NSURLConnections AND use connection:didSendBodyData:totalBytesWritten:totalBytesExpectedToWrite:

PICTURE: Privacy

Add private/public

Save picture

Depends on the settings, the app needs to save the picture to the photo album.

Validation when app is updated

The app should know if it comes from an updated. If yes, remove from user default data when necessary. Keep the actual version in the Constants.h and the application is opened for the first time save this in the user default data.

Remove fake data

In the Gallery and Photo from Gallery there are some fake code used for the release 1.0. It must be removed and changed the classes names.

Add a better button for uploading picture

Add a better design to the app

Move all frameworks

All frameworks are located in the root of the source code. Move them to another folder, e.g.: plugins or frameworks

API returns NULL when there are no photos

I updated the API to return NULL when there are no photos.
http://current.openphoto.me/photos/tags-notagexists/list.json

iOS needs changes.

Error on attempted iOS install

Upon attempting to install the iOS app via the TestFlight website (after following all the instructions for special provisioning/adding certificates) I get the following error:

Unable to Download Application

"OpenPhoto" could not be installed at this time.

I am running iOS 5 beta 7 on an iPhone 4.

GALLERY: Load more

Create a functionality to get more 25 images…. to load pictures (there is a fake example already in the code)

Apply better design