Get Source Code

The OSMF project is one of several open-source projects in a Subversion repository hosted by Adobe. Subversion is an open-source revision control system used for many open-source projects. If you haven't used it before, please see the official documentation. For a high-level overview of source control concepts, see A Visual Guide to Version Control.

There are two ways to access the repository. You can use any web browser to see the structure of the project and view the latest version of each file. However, you must use a Subversion client to perform more complex operations such as reviewing the commit log, looking at older revisions or diffs, or checking out your own working copy to build and test.

Web browsing

To browse the OSMF project, go to http://opensource.adobe.com/svn/opensource/osmf.

Within the project are directories named trunk, branches, and tags, as is standard for Subversion projects.

The trunk is work-in-progress on the version under current development, which is currently OSMF 1.0. The trunk should build and pass basic tests but may be unstable and unsuitable for use.

Tags record the code that shipped as a specific release, or other milestones in a project. The code which was used to build the Sprint 5 release of OSMF has been tagged as tags/sprint5-stable. Every stable milestone release is tagged in a similar manner.

This site often uses the word “branch” as shorthand for “trunk, branch, or tag”.

Installing a Subversion client

To get your own working copy of the source code, you'll need a Subversion client. A client will also let you see the repository structure, look at the revision history of any file or directory, diff two versions of a file, etc.

The OSMF team has had good experience with TortoiseSVN on Windows and SmartSVN on Macintosh, both of which are GUI clients. (This is not an official endorsement of these products by Adobe.) Of course, you can use whatever client you prefer, including Subversion's official command-line tool svn. We'll assume you're using svn in our instructions.

You can get the Subversion installer, which includes svn, here:

After installing svn using the Windows installer, you should be able to execute svn from any directory because it will be found on your PATH.

On Macintosh, test the installation by opening Terminal and executing:

svn --version

If you get svn: command not found, then you'll need to add the /usr/local/bin directory onto your PATH, since this is where svn lives. Assuming you're using the default bash shell in Terminal, you can do this by putting the following lines into a ~/.bash_profile file:

PATH="/usr/local/bin:$PATH"
export PATH

Otherwise, you'll have to invoke svn as /usr/local/bin/svn.

Access rights

Everyone has read-only access to the OSMF project. You don't need a username or password.