Difference between revisions of "CC Publisher"

From Creative Commons
Jump to: navigation, search
Line 1: Line 1:
 
[[Category:CcPublisher]]
 
[[Category:CcPublisher]]
[[Category:Developer]]
 
 
[[Category:opensource]]
 
[[Category:opensource]]
 
[[Category:Technology]]
 
[[Category:Technology]]
  
ccPublisher is Creative Commons's tool for generating license information for a file and optionally uploading it to the [http://archive.org Internet Archive] for free hosting.  ccPublisher also serves as a platform for development of other CC enabled tools. We are currently working on ccPublisher 2, which is primarily an "internal improvement" release. No new features will be added, but the code base has received significant attention in order to enable easier addition of features and development of derivative works.
+
''We're in the process of updating this to include some user documentation; bear with us... '' [[User:NathanYergler|Nathan]]
  
= Users =
+
==What is it?==
  
You can download pre-release versions ccPublisher 2 from the [[ccPublisher 2 Releases]] page. If you have questions or problems with ccPublisher, please do one of two things:
+
ccPublisher is a tool that does two things: it will help you tag your audio and video files with information about your license and it allows you to upload Creative Commons-licensed audio '''and''' video works to the [http://archive.org/ Internet Archive] for free hosting. You also have the option of publishing the licensed and tagged audio works on your own site.
  
* email software@creativecommons.org (good)
+
==Installing ccPublisher==
* file a bug or feature request in the [http://roundup.creativecommons.org/ccpublisher ccPublisher Tracker] (better)
+
 
 +
Installing the application is as simple as downloading the appropriate package below. Once downloaded simply double click the installer (Windows) or drag the application file to your Applications directory (Mac), then run the program.
 +
 
 +
'''Windows'''<br />
 +
[http://mirrors.creativecommons.org/software/publisher/ccpublisher-1.1.1.msi CC Publisher 1.1.1.msi] (Windows XP/2000 Installer Package)
 +
 
 +
'''Mac'''<br />
 +
[http://mirrors.creativecommons.org/software/publisher/ccPublisher-1.1.1.dmg CC Publisher 1.1.1.dmg] (Mac OS X Disk Image)
 +
 
 +
==Using ccPublisher==
 +
 
 +
<span class="publish-pics"><img src="/images/publish/1-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder"  /></a></span>
 +
<h3 class="orange">Step one: Dragging your songs/videos into CC Publisher</h3>
 +
 
 +
<p class="index-blurbs" style="margin-bottom:30px;">
 +
Start the CC Publisher application and hit Next on the introductory screen. The process starts by adding your files to be tagged/uploaded. You can use the browse function to find the files, or simply drag and drop as many files that you would like to license (all with the same license) and upload (all into the same collection at Internet Archive).
 +
</p>
 +
<br clear="all" />
 +
 
 +
<span class="publish-pics"><img src="/images/publish/2-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder"  /></a></span>
 +
<h3 class="orange">Step two: Adding information about your works</h3>
 +
 
 +
<p class="index-blurbs" style="margin-bottom:30px;">
 +
The next screen will ask for information about your recording or video, which will help others find it at the archive and build up the metadata in your audio files.
 +
</p>
 +
<br clear="all" />
 +
<span class="publish-pics"><img src="/images/publish/3-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder"  /></a></span>
 +
<h3 class="orange">Step three: Choose your license</h3>
 +
 
 +
<p class="index-blurbs" style="margin-bottom:30px;">
 +
CC Publisher lets you choose one of several license types and the options for each.</p>
 +
<br clear="all" />
 +
 
 +
<span class="publish-pics"><img src="/images/publish/4-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder"  /></a></span>
 +
<h3 class="orange">Step four: Logging into the Internet Archive</h3>
  
= Developers =
+
<p class="index-blurbs" style="margin-bottom:30px;">
 +
To upload your works to the Internet Archive, you'll need an account there to associate your files with. If you don't have an account there, there is a handy button within CC Publisher that will launch a web browser and allow you to join it.
 +
</p>
 +
<br clear="all" />
 +
<span class="publish-pics"><img src="/images/publish/5-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder"  /></a></span>
 +
<h3 class="orange">Step five: Start your upload to the Archive</h3>
  
'''NOTE FOR DEVELOPERS'''
+
<p class="index-blurbs" style="margin-bottom:30px;">
ccPublisher has moved its active source code repository from [http://sf.net/projects/cctools SourceForge.net] to [http://developer.berlios.de/projects/cctools Berlios.de].  For details on CC projects at Berlios, see [[ccTools Berlios]].
+
The final step is to upload your works to the Internet Archive. Depending on your connection and the size of files you are uploading, this step can take anywhere from a few seconds to several hours.
 +
</p>
 +
<br clear="all" />
 +
<span class="publish-pics"><img src="/images/publish/6-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder"  /></a></span>
 +
<h3 class="orange">Step six: All done!</h3>
  
== Overview ==
+
<p class="index-blurbs" style="margin-bottom:30px;">
* [[ccPublisher 2 Architecture]] Design documents for the ccPublisher 2.0 architecture (and P6 core).
 
* [[ccPublisher 2 Roadmap]] Target dates for releases and features to be included in each.
 
* [http://mirrors.creativecommons.org/developer/doc/p6/current/ Autogenerated API documentation]
 
  
== Documentation ==
+
When your upload is complete, the Publisher application will furnish you with a URL that should be live within 24 hours at the Archive. If you'd like to use a file-sharing application or add the files to your own website, the file can be found in its original location on your computer, which you can upload to a site or move into a shared downloads folder for P2P (for more info, see <a href="http://creativecommons.org/audio/publish-morpheus">our tutorial for sharing your CC music via Morpheus</a>).</p>
* [[Developing ccPublisher 2]] Checking out a sandbox from Subversion and working with the code
 
* '''Customizing ccPublisher 2'''
 
** [[Customizing ccPublisher 2]] Creating new versions of ccPublisher that support different metadata sets or different backends.
 
** [[Extending ccPublisher]] Creating extensions to add functionality to ccPublisher
 
** [[Writing a Storage Provider]] Adding support for new upload repositories to ccPublisher 2 and P6-based applications
 
* [[CcPublisher Release Procedure|ccPublisher Release Procedure]] Information on creating releases and packages.
 
  
== Resources ==
+
== Support ==
* [http://roundup.creativecommons.org/ccpublisher/ ccPublisher Tracker] Bug reporting and feature request tracking
 
* [[Reporting Issues]] Information on submitting useful issue reports
 
  
= ccPublisher 1.x =
+
If you have problems with ccPublisher, or just questions or suggestions, you can do one of two things:
  
ccPublisher 2 is now at the point where it is more stable than ccPublisher 1.x for most users. We recommend using the latest release of ccPublisher 2.
+
* email software@creativecommons.org (good)
 +
* file a bug or feature request in the [http://roundup.creativecommons.org/ccpublisher ccPublisher Tracker] (better)
  
* [http://sourceforge.net/tracker/?group_id=80503&atid=559966 Bug Tracker at SourceForge]
+
== Developers ==
* [[ccPublisher 1x Hacking]] How to get started with the ccPublisher 1.x source code
 
  
For information on using ccPublisher 1, see the [http://creativecommons.org/tools/ccpublisher ccPublisher page at creativecommons.org].  It has pictures.
+
ccPublisher developer information is located on the [[CcPublisher Developer|ccPublisher Developer]] page. Discussion about feature requests and development takes place on the [[Mailing Lists|cc-devel]] mailing list.

Revision as of 16:38, 19 May 2006


We're in the process of updating this to include some user documentation; bear with us... Nathan

What is it?

ccPublisher is a tool that does two things: it will help you tag your audio and video files with information about your license and it allows you to upload Creative Commons-licensed audio and video works to the Internet Archive for free hosting. You also have the option of publishing the licensed and tagged audio works on your own site.

Installing ccPublisher

Installing the application is as simple as downloading the appropriate package below. Once downloaded simply double click the installer (Windows) or drag the application file to your Applications directory (Mac), then run the program.

Windows
CC Publisher 1.1.1.msi (Windows XP/2000 Installer Package)

Mac
CC Publisher 1.1.1.dmg (Mac OS X Disk Image)

Using ccPublisher

<img src="/images/publish/1-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder" /></a>

Step one: Dragging your songs/videos into CC Publisher

Start the CC Publisher application and hit Next on the introductory screen. The process starts by adding your files to be tagged/uploaded. You can use the browse function to find the files, or simply drag and drop as many files that you would like to license (all with the same license) and upload (all into the same collection at Internet Archive).


<img src="/images/publish/2-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder" /></a>

Step two: Adding information about your works

The next screen will ask for information about your recording or video, which will help others find it at the archive and build up the metadata in your audio files.


<img src="/images/publish/3-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder" /></a>

Step three: Choose your license

CC Publisher lets you choose one of several license types and the options for each.


<img src="/images/publish/4-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder" /></a>

Step four: Logging into the Internet Archive

To upload your works to the Internet Archive, you'll need an account there to associate your files with. If you don't have an account there, there is a handy button within CC Publisher that will launch a web browser and allow you to join it.


<img src="/images/publish/5-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder" /></a>

Step five: Start your upload to the Archive

The final step is to upload your works to the Internet Archive. Depending on your connection and the size of files you are uploading, this step can take anywhere from a few seconds to several hours.


<img src="/images/publish/6-ccpublisher.gif" width="200" height="200" alt="using CC Publisher" class="imgborder" /></a>

Step six: All done!

When your upload is complete, the Publisher application will furnish you with a URL that should be live within 24 hours at the Archive. If you'd like to use a file-sharing application or add the files to your own website, the file can be found in its original location on your computer, which you can upload to a site or move into a shared downloads folder for P2P (for more info, see <a href="http://creativecommons.org/audio/publish-morpheus">our tutorial for sharing your CC music via Morpheus</a>).

Support

If you have problems with ccPublisher, or just questions or suggestions, you can do one of two things:

  • email software@creativecommons.org (good)
  • file a bug or feature request in the ccPublisher Tracker (better)

Developers

ccPublisher developer information is located on the ccPublisher Developer page. Discussion about feature requests and development takes place on the cc-devel mailing list.