OpenomyFS

OpenomyFS is a Ruby program that uses the FUSE library to mount your Openomy account as a filesystem on any FUSE supported OS.

OpenomyFS has been re-released, and is now part of the Openomy Open Source Library. Visit it on sourceforge for the download. The package is called 'openomyfs-ruby'.

Create an empty directory, such as /mnt/openomy

Run OFS:

root@moocow:~ # ruby ofs.rb /mnt/openomy &

OFS might ask you for authentication: It needs you to authorize it to access your Openomy account. It will present you with a URL to go to where you will sign in to Openomy and authorize the application. You will only need to do this the first time it is run, as OFS will save the authentication tokens in your home directory, in $HOME/.ofs.yml

• /tags : This directory contains a directory for each tag you have defined on Openomy. You can define new tags by using 'mkdir' and you can delete tags using 'rmdir'. Each tag directory has all of the files that are stored under this tag. Deleting a file from these directories removes the file from the tag. Similarly, copying a file into one of these directories saves that file under that tag. All of the files here are readable, writable, and executable.
• /files : This directory contains all of your Openomy files. Deleteing files from this directory actually deletes the files from Openomy. Writing to these files saves the changes to Openomy, and creating new files here will upload them as well. All of the files here are readable, writable, and executable

Special note: the 'touch' command-- OpenomyFS uses caching to keep the filesystem as responsive as possible. However, if multiple people are accessing the same files, it is possible for OpenomyFS and Openomy to become out of sync (for example, on shared tags). To clear all the caches and force OpenomyFS to fetch new data use the 'touch' command. For example, use 'touch /tags/tag1' to clear all the cached tag data, and 'touch /files/file1' to clear all the cached file data.

1. Download and install FUSE. For more information, see the FUSE website
2. Download and install Ruby, if you dont have it already. Most Linux distributions should package it for you. If not, checkout the main Ruby site for the download.
3. Download and install the Ruby FUSE bindings from the FuseFS page on RubyForge (version >= 0.6.0 required).
4. Download OFS from sourceforge. The tarball includes OFS, the latest openomy-ruby library, and a readme file.

If you have any comments, suggestions, or bug reports, please email Maurice Codik at maurice.codik@gmail.com.