Documentation

Documentation for Regal Media software is taking shape. If you have specific suggestions, please leave a comment on a particular page.

TouchFS Documentation

The following documentation will help you learn about and evaluate TouchFS.

What Is TouchFS?

TouchFS™ turns your iPhone or iPod Touch into a wireless thumb drive, allowing you to transfer files from your PC or Mac to it. TouchFS makes this easy. Once your computer connects to your iPhone running TouchFS, you can simply drag and drop any files to it—you can treat your iPhone or iPod Touch like an external network drive.

TouchFS does this by running a WebDAV server on your iPhone or iPod Touch. You can then use your computer's built-in WebDAV connection features to connect to it and transfer files back and forth.

Once your files are transfered to your iPhone, you'll be able to browse through them and even view some of them directly on the screen. Imagine copying the latest sales report to your iPod Touch and bringing it on the road with you without having to lug around your laptop. Imagine copying the latest web site design to your iPhone and showing it to a client in the palm of your hand.

How To Connect From OS X


First, ensure the TouchFS server is switched ON in the Options screen and make note of the URL or address displayed there. You'll need to enter this complete URL on your computer in the next step.

To make your first connection easier, turn the Authentication option OFF.




Next, choose Go | Connect to Server... from the Finder, and enter the connection URL in the Server Address field. (That's the address of your iPhone or iPod Touch–the address displayed on the TouchFS Options screen above)

Make sure the URL you type in begins with http://, otherwise the Finder will not know how to connect to your iPhone. Also, make sure you include the port number at the end of the URL, otherwise, again, no connection will be possible.


If you have authentication turned off, TouchFS will prompt you to accept the incoming connection from your computer. Touch Yes to allow your computer to connect.


If you have authentication turned on instead, your computer will prompt you for a username and password. Enter the same values you have set in the TouchFS Options screen.

Once connected, you'll see a new drive on your desktop labeled with your iPhone's IP address. If your Finder preferences disallow network drives from appearing on your desktop, you'll see the new drive in the sidebar of any Finder window instead–in the Shared section.

How To Connect From Linux Using Konqueror

An iPhone or iPod Touch running TouchFS can be connected to from any computer or device that can connect to a WebDAV server. From the TouchFS screen, tap the Options button and make note of the IP address and any user name and password you have entered.

Then, from your other computer or device, use whatever WebDAV software it has installed to connect to this address.

For example, to connect to TouchFS using the popoular Konqueror browser, enter the TouchFS address as a webdav:// url as so:

webdav://192.168.0.7:8080/

Konqueror will show all the files stored on your iPhone with TouchFS. You can move/copy/delete/rename them there as well.

How To Connect From Windows XP

NOTE: If you have trouble connecting w/XP, please install the Software Update for Web Folders patch from Microsoft. It can be found at this location:
http://www.microsoft.com/downloads/details.aspx?FamilyId=17C36612-632E-4...


Connecting your iPhone or iPod Touch running TouchFS to your PC running Windows XP is easy.


First, tap the Options button in TouchFS to setup and view your current settings. Make note of the URL you're shown and and user/password you may have configured.


From My Computer, open up My Network Places, choose Add a network place and click Next.


Wait for Windows to load information about network serivce providers. Select Choose another network location and click Next.


Enter a url containing your device's IP addresss and port number as displayed on the
TouchFS Options page, then click Next.

Example: http://192.168.0.2:8080/


Windows will attempt to connect to your iPhone. Depending on the Authentication options you have set in TouchFS, your computer will either prompt you for a username and password, or TouchFS will prompt you to allow the incoming connection. (If prompted for a username and password, enter the ones configured in the TouchFS Options screen)


Name this connection whatever you like. (iPod and My iPhone are great names, but so are William, Susan and George.)


Click through to the end of the wizard, and you'll finally see your new iPhone connection in My Network Places


To verify this is setup correctly, right-click the newly created network place, and choose Properties...


...and make sure the URL listed in the Target field is correct. (Make sure it starts w/ http://. There is a bug in certain installations of Windows that removes the http:// from the URL you enter in the wizard. No http:// means the connection won't work.)


Once you're happy that the network place is configured correctly, double click it to open it up. When opened, you'll see a list of the files stored within TouchFS on your iPhone or iPod Touch. You can drag and drop, copy, move, delete, rename directly from this window, just like in any Explorer window.

See? Wasn't that easy? Nothing more than a simple seven eight step process. If this sounds too hard, don't worry...it sounds much worse than it is.

How To Connect From Windows Vista

NOTE: Before your try to connect w/Vista, make sure you have Vista Service Pack 1 installed, as it greatly improves upon the WebDAV experience.


Connecting your iPhone or iPod Touch running TouchFS to your PC running Windows Vista is easy.


First, tap the Options button in TouchFS to setup and view your current settings. Make note of the URL you're shown and and user/password you may have configured.


From My Computer, open up Network, choose Tools | Map Network Drive.


Next, DO NOT enter anything in the Folder: text box, but instead click the Connect to a Web site... link at the bottom of the window.

Wait for Windows to load information about network serivce providers. Select Choose another network location and click Next.

(After this, you can ask us why this had to have so many steps, and why you couldn't just enter the address in the main text box in the first place. We'll then get right on asking Microsoft these same questions *smirk*)


Enter a url containing your device's IP addresss and port number as displayed on the
TouchFS Options page, then click Next.

Example: http://192.168.0.2:8080/


Windows will attempt to connect to your iPhone. Depending on the Authentication options you have set in TouchFS, your computer will either prompt you for a username and password, or TouchFS will prompt you to allow the incoming connection. (If prompted for a username and password, enter the ones configured in the TouchFS Options screen)


Name this connection whatever you like. (iPod and My iPhone are great names, but so are William, Susan and George.)


Click through to the end of the wizard, and you'll finally see your new iPhone connection in Web Folders


To verify this is setup correctly, right-click the newly created network place, and choose Properties...

...and make sure the URL listed in the Target field is correct. (Make sure it starts w/ http://. There is a bug in certain installations of Windows that removes the http:// from the URL you enter in the wizard. No http:// means the connection won't work.)

Once you're happy that the network place is configured correctly, double click it to open it up. When opened, you'll see a list of the files stored within TouchFS on your iPhone or iPod Touch. You can drag and drop, copy, move, delete, rename directly from this window, just like in any Explorer window.

Connecting With Other WebDAV Software

Here's some brief information detailing the other WebDAV software available on each operating system, and how to set them up correctly. If you find another tool that's not mentioned here, feel free to leave a comment at the bottom of this page.

Cyberduck (OS X)

Cyberduck is a free FTP and WebDAV client for Mac OS X, and should work with TouchFS if the standard Finder connection is not working for you.

You can read about and download Cyberduck at http://cyberduck.ch/.


To make things easier at first, turn the authentication OFF in the options screen.


Launch Cyberduck, and click the Open Connection toolbar button. In the sheet that slides out, configure a connection using this screenshot as a guide. Choose WebDAV from the Protocol dropdown, and enter the IP address and port number in the Server and Port fields. The values to use are shown in the TouchFS Options screen. Then, check the Anonymous login checkbox and click Connect.


TouchFS will then prompt you to allow the incoming connection. Tap Yes to allow Cyberduck to connect.


Once connected successfully, Cyberduck will display the files stored on your iPhone via TouchFS. You can drag and drop files from the Finder to upload new files, and can delete/rename/move/copy files from within the Cyberduck window.

AnyClient (Windows XP & Vista)













How To Connect From A Web Browser

TouchFS allows you to view your files with a standard web browser. File uploading with a web browser will work too.

Being able to access your files in a web browser is a nice-to-have feature for when you're near a computer without any WebDAV client, or can't get the WebDAV client to connect. It's not intended to be the main way to upload and manage your iPhone files, but will work in a pinch.

Just open the TouchFS url displayed on the Options screen in a standard web browser. Depending on your TouchFS Security options, either your web browser will prompt you for a username and password, or TouchFS will prompt you to allow the incoming connection.

Once connected, you'll be able to browse your files and folders in your web browser and can even upload new files as well.

Release Notes

Here's a list of the fixes and features incorporated into TouchFS as its development has progressed:

1.4
  • Updated for iPhone OS 3.1
  • Added URL download support. Enter a URL, or copy one from another application and TouchFS can download it.
  • Improved support for Leopard and Snow Leopard's Finder WebDAV client
  • Added support for rtf files
  • Added support for iWork '09 flat file format
1.3
  • Added quick scrolling slider for PDF and Office documents
  • PDF and Office viewer remembers/restores previous document position
  • TouchFS disables sleep when the WebDAV server is running
1.2
  • Added Unicode (UTF8) filename support (Files like "Gøød Fîlénåmë.pdf" work)
  • Added Keynote document viewer (when saved w/preview)
  • Added ability to delete files from within TouchFS
  • Fixed port option being ignored. Port can only be changed when the TouchFS server is OFF, but will now work.
1.1
  • Added Office document viewers (Word, Excel, PowerPoint)
  • Added iWork document viewers (Numbers & Pages when saved w/preview)
  • Fixed case-sensitive file extensions. Viewable files are now viewable regardless of file extension case.

Groupify Documentation

Groupify documentation is being added this week.

Groupify is an application for your iPhone or iPod Touch that allows you to create/delete groups in your address book, along with managing the members of those groups. You can add and remove contacts to groups directly on your device.

TipAndTax Documentation

There's a thousand and one tip calculators in the App Store. Find out why you'll like TipAndTax within these pages.