sensible-cinema 0.21.9 → 0.21.10

data/LICENSE.TXT

@@ -1,79 +1,15 @@
-All files (c) Roger Pack 2010
-All files released under the GPLv3 license [1] unless otherwise specified.  Ping me if you want/need this changed at all.
+All files (c) Roger Pack 2010-2011
 
-The edit lists, however are public domain.
+All files released under the GPLv3 license [1] unless otherwise specified.  Ping me if you want/need this changed at some point.
 
-Note: may call out to some 3rd party libraries/executables under their own (separate, open source) licenses.
-
-So...is this legal?
-
-Unclear.  In general ripping personal DVD's is legal.
-And making "backup copies" of commercial DVD's (I think--I'm no laywer) may fall under fair use [3] .
-
-It is controversial to use open source software to play/rip commercial DVD's.
-There are a few conflicting views.  
-Sensible-cinema doesn't actually do any decryption or decoding, nor has any knowledge of it.  
-It doesn't even have knowledge
-as to whether the DVD being ripped is encrypted or not.  We don't distribute sensible-cinema with
-the ripping program, or any ripping codes, either (the user must install it later after being prompted).
-You can ask the authors of that program if it is legal.  Apparently
-libdvdcss (which the other programs that it calls out to use) has never been legally challenged in court (or so they say), 
-and uses a slightly different algorithm than those that have, so the jury's out.
-Also since we only call out to another (separate) executable, we're as legal as audacity calling out to winlame.dll for its
-mp3 conversions, or perhaps similar to Handbrake calling out to VLC Media Player.  Use only after knowing the risk.
-Using sensible-cinema is also might not be more unethical than ripping your DVD collection to your hard
-drive so you can "keep your DVD's all in one place" or what not (which might be fair use), since it
-basically saves away the original with sections removed.  Only original content is saved.
-It's about the same as using VLC media player to watch a DVD, which also uses libdvdcss.
-Also note that if you watch an edited DVD in a commercial DVD player, your are using a DVD player that conforms
-with encryption specifications, so that might have some sway.
-Note also that fair use at times does allow one to "record" things for personal use/backup (for example off the TV).
-Note that sensible cinema does require the original DVD to be present when using it, also.
-
-If general, if it's not legal in your country, then don't use it!
-You are responsible for your actions and use of this program.
-It is possible that the authors of sensible-cinema are not cupable of anything
-regarding its use themselves, since they re-distribute no edited media, 
-nor distribute cracking codes.  Check your country's rules first.
-If it's illegal, don't use it!
-
-Note: for sure do not redistribute/re-sell edited DVD's.  We have learned from clean flicks that
-redistributing (well at least renting/selling) edited commercial DVD's is against copyright in the US.  We hope that sensible-cinema
-is more legal, since you basically have to have the original DVD in hand.
-Please don't redistribute.  If creating copies of commercial DVD's is illegal
-in your country, then don't do it!  Use the "watch in realtime" option.  Unless that's illegal.
-USING THIS SOFTWARE MIGHT BE ILLEGAL IN SOME COUNTRIES.
-DO NOT MAKE ILLEGAL COPIES.
-
-In terms of copyright, it could be legal under the The Family Home Movie Act of 2005,
-at least in the United States, when viewed using the "playlist" option (v 0.10'ish, later removed--used VLC), or the "realtime" option (0.18.0'ish +, using mplayer).
-In general, if I have the original DVD sitting next to my TV, I don't feel bad about watching
-its edited copy, but please consult a laywer first if you have any concerns.
+The edit lists included, are creative commons licensed.
 
-This program can also be used for editing home movies, etc (example, the "pack wedding" file herein included).
-
-Note that this software might well be legal in the EU, 
-as it is only software (if you watch it on your computer), and therefore possibly not subject to patents in certain countries
-(see "What about patent licenses?" in [2]).
-
-Also note that several ideas have been released in the code that are disabled in the final release.  Please see the blog
-for release notes http://betterlogic.com/roger, as well as http://ruby-forum.com (ruby talk ML there), and rubygems.org
-which lists the various releases, including release notes, when installed, and also github.com/rdp/sensible-cinema which,
-lists commits and changes and release notes, and is publicly available.
-
-A more ancient history of various brainstorming thoughts was described here:
-http://betterlogic.com/roger/?p=2618
-
-Note sensible cinema is distributed free for free, source code is also available (see README text file).
-
-YOU MUST AGREE TO THE gplv3 in order to use this software.
+Note: may call out to some 3rd party libraries/executables under their own (separate, open source) licenses.
 
-Note also that we used parts of the 7-Zip program, that 7-Zip is licensed under the GNU LGPL license, see http://www.7-zip.org, where the source code can be found.
+Note also that we used parts of the 7-Zip program, that 7-Zip is licensed under the GNU LGPL license, see http://www.7-zip.org, where its source code can be found.
 
-See also the README text file which contains some invention related notes.
+Ffmpeg is included, under the GPLv2: http://www.ffmpeg.org/legal.html http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 
-[1] http://www.gnu.org/licenses/gpl.html, also gplv3 file.
-[2] http://www.videolan.org/legal.html
-[3] http://www.macworld.com/article/150731/2010/04/dvdripping_faqs.html
+curl is included, released under an MIT/X style license: http://curl.haxx.se/docs/copyright.html
 
-note also http://en.wikipedia.org/wiki/DVD_Decrypter
+See first also the file "is_it_legal_to_copy_dvds.txt" for more information on legal use in your country.

data/README

@@ -1,33 +1,37 @@
-Sensible-cinema (also known to us as "paranoid cinema" [our own inside joke ha ha]) allows you to apply 
-pre-programmed delete lists (e.g. Edit Decision Lists [2]) to DVD's you already own.  It is currently in beta,
-though will always be free software, even after release.
-
-I.e. you can play or edit a DVD to "mute out" or skip certain scenes.
-
+Sensible-cinema [5] allows you to apply pre-programmed delete lists
+(e.g. Edit Decision Lists [2]) to DVD's you own.  
+I.e. you can edit a DVD to "mute out" or skip certain scenes.
 This allows you to sit back and relax as you watch a more "sensiblized" showing of your DVD.
 
-Note: please install from the zip files at http://rogerdpack.t28.net/sensible-cinema and not from gitub.
+It is currently in beta, though will always be free software, even after release.
+It also includes a library of EDL's that go along with various DVD's, we need volunteers
+to help it to grow!
 
-To use it, basically install, then insert an original DVD that you want to edited, then run sensible cinema.
-It will pop up some windows where you choose what to do with that DVD.
+To use, basically install, then insert an original DVD that you want to edited, then run sensible cinema.
+It will pop up some windows where you choose what to do.
 
-You can either watch it edited in realtime from the DVD, or created an edited 
-video version of the DVD (an sensibilized video file), on your hard drive.
+Note: please install from the zip files at http://rogerdpack.t28.net/sensible-cinema and not from gitub's "downloads" button.
+See the "install" section.
 
-How? Sensible cinema basically takes the original DVD, slices out the bad parts, then gives you the result.
-It is essentially a linear editor [1] that applies Edit Decision Lists [2] to videos.  It wraps
+It basically allows you to create an edited video version of the DVD, onto your hard drive, and you can watch it there.
+
+How? Sensible cinema basically takes the original DVD, slices out the bad parts, then combines it back
+into a new file and gives you the result.
+It is basically a linear editor [1] that applies Edit Decision Lists [2] to videos.  It wraps
 a few freely available open source programs [3] to accomplish the editing for you.
 It also has a few "realtime viewing" options available, again based on open source software [3].
 
 Note that the whole process can take several hours, so budget some time for it.
 
 Also note that just because an edited video lacks profanity...does not immediately make it an inspiring experience.
-I'd suggest carefully evaluating your motives, and going with those.
+I'd suggest carefully evaluating your real values, and going with those.
 Sensible cinema does not a clean movie make of a dirty one.  Don't watch it if it's not wholesome! Be nice to yourself!
 
-dove.org and common sense media are good references for discovering the "uplifting" level of movies [4].  
-Also note that even if you have an edited copy of a DVD floating around, if you have kids, chances are they
-will eventually find (and watch) the unedited originals, so be careful there, and do what is needed.
+dove.org and common sense media are good references for discovering the "uplifting" level of movies [4].
+kids-in-mind.com is also a good reference for profanity levels, though sometimes it misses profanities,
+and it also lacks timestamps to know when the profanities occur.  Hence this project.
+Also note that even if you happen to have an edited copy of a DVD floating around, if you have kids, chances are they
+will eventually find (and watch) the unedited originals, so be careful there.
 
 Enjoy your movies!
 
@@ -35,88 +39,103 @@ Enjoy your movies!
 [2] http://en.wikipedia.org/wiki/Edit_decision_list
 [3] mostly GPL programs, see http://www.gnu.org/licenses/ VLC Media Player, Mplayer/mencoder, ffmpeg, et al.
 [4] http://lds.org/library/display/0,4945,161-1-11-1,00.html search for the word "wholesome"
+[5] Also known to us as "paranoid cinema" (our inside joke :).
 
 == Installation ==
 
-Instructions available here: http://rogerdpack.t28.net/sensible-cinema
-NB that you want to download from there, not from github, and the file you want is called "latest-sensible-cinema.zip"
+Installation instructions available here: http://rogerdpack.t28.net/sensible-cinema
+NB that you want to download from there only, not from github, and the file you want to get
+is called "latest-sensible-cinema.zip"
 
-== Creating Your Own Delete Lists, or modifying the previously existing ones ==
+== Creating Your Own Delete Lists, or modifying previously existing ones ==
 
 See the accompanied how_to_create_your_own_delete_lists.txt file.
 
-== Creating your own edited DVD ==
+== Creating an edited DVD ==
 
-I don't know how I've never burned a DVD.
+See also is_it_legal_to_copy_dvds.txt for some caveats you should understand.
+I don't actually know how I've never burned a DVD.
 Windows DVD Maker might help, http://www.dvdflick.net might help.
-See also LICENSE.TXT for some caveats you should understand first.
+iDVD might help on mac.
+DO NOT MAKE ILLEGAL COPIES OF DVD's. See is_it_legal_to_copy_dvds.txt.
 
 == FAQ ==
 
 Q. How do I watch these on my TV, not just on my computer?
 A. You also might be able to move a laptop over to near your TV and hook it in from your laptop.
   Or buy a very long monitor cord and plug it in from your desktop/laptop.
-  You could also buy a projector, attach it to your laptop, and then use that to display the video.
+  You could also buy a projector, attach it to your laptop, and then use that to watch it.
   If you're interested in also being able to "beam" it from your computer to your game console (ex: PS3) ping me--I might have 
   something in mind that could help, though hasn't been created yet.  (Playon.tv does something like this, too, but
-  I might come up with a competitor to it if desired, as it costs).
+  I might come up with a competitor to it if desired, as the existing one costs money).
   If you're really ambitious and bleeding edge you could even try VGA over an Ethernet cable, too: 
-  http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=5731#p34279  
+  http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=5731#p34279
+  You may be able to create your own edited DVD, see section "Creating an edited DVD"
+  You may be able to come up with some real-time player editor, too, see section "related works" et al
 
 Q. I want to give an edited DVD to a friend, how do I do that well?
-A. Give them the original DVD and a link to sensible-cinema's website so they can download and use it.
+A. Give them the original unedited DVD and a link to sensible-cinema's website.
 
 == Caveats ==
 
 NB that "someone" has to first create a delete list, per DVD.
 If one doesn't yet exist for the DVD you want edited,
-you could employ somebody to create it, or create it yourself.  Make sure to submit it
-back to us when you're done, so that everyone can benefit from it.
-Fortunately only one person has to do it, once, for everybody to benefit, and the 
-editing process is fairly easy.
+you could create it yourself, or employ somebody to create it.  Make sure to submit it
+back to us when you're done, so that the rest of the users can benefit from it.
+Fortunately just one person has to do it, once, for everybody to benefit, and the 
+editing process is not too bad.
+
+We also have a subtitle parser which really helps locate profanity more conveniently, so that will help you
+build your delete list.
 
 Also note that if your DVD has scratches that cause it to skip, the time signatures will be off, 
-so we recommend to always clean your discs!
+so we recommend to always clean your discs first!
 
 == Motivation ==
 
 The initial motivation for the project was that I dislike deity profanity in movies.
 And really any profanity is jarring, if you're not used to it in real life, and can
-put you a bit on edge when you watch a movie.  
-Also sometimes producers put in certain scenes (read: sex scenes) just to get a rating.
-I don't want just those scenes, but still want to be able to watch the movies :)
+put you a bit on edge when you watch a movie.
+Also sometimes producers put in certain scenes (read: sex scenes) 
+just to get a desired rating.
+I don't want those scenes, but still want to be able to enjoy said movies :)
 
 I once tried Clearplay (a "filter"ed DVD player)
-but (for me) it didn't seem to cut it.  It costs money monthly (I'm too cheap to pay--and many
-many other people don't use it because of this fact...).  Their
+but (for me) it didn't cut it.  It costs money monthly (I'm too cheap to pay--and many
+many other people don't use it because of this...).  Their
 filters sometimes don't cut out all unwanted content (ex: Saints and
 Soldiers left profanity in...which wasn't what I had
-expected, so they differed in standards somewhat).  
+expected), so if they differ in standards somewhat, you're out of luck.  
 Others have noted that sometimes their edit timings (or perhaps DVD players)
-are slightly mismatched so that it will mute sections just previous to profanity, while
-not muting the profanity itself.  Clearplay apparently also runs a rather 
-confusing subscription policy, I'm told [1], as well as selling DVD players that 
-are a bit lackluster at times [2].
-Clearplay also has little community collaboration/review (though you can email them feedback).
-They no longer seem to have a "request a filter" option, though they used to.
+are slightly mismatched so that it will end up muting sections just previous to profanity, while
+not muting the profanity itself, or so I've heard.  Clearplay apparently also runs a rather 
+confusing subscription policy, so I'm told [1], as well as selling DVD players that 
+are a bit lackluster at times [2].  Their DVD players aren't quite as readily accessible (read: 
+can't buy at walmart anymore), nor as cheap to buy as some out there.
+Clearplay also has little community collaboration/review (though you can email them feedback I suppose).
 They also don't have filters for all movies that I, at times, would like to watch edited (Condorman and Tron
 lacking last time I checked...probably because they are too
-obscure.) Also, some people watch movies only on computer, and they
-no longer have a computer player, only hardware DVD players.  They also don't edit streamed
-online movies either (last time I checked, anyway).  So overall I
-wanted to build my own that overcame some of these hurdles.
+obscure.) If there isn't one, you basically have to request one and then *hope* they get around to it.
+They might never get around to it, or it might take a bit longer than you'd hope.
+Also, some people watch movies only on computer, and they
+no longer seem to offer a computer player, just hardware DVD players.  They also don't edit streamed
+online movies either (last time I checked, anyway), nor offer a blu-ray player.  
 I also emailed them once (2003?) to inform them I'd be making an open source
 equivalent, and haven't heard back, which I assume to mean implicitly
-they're all for it :)
-Also no blu ray player support.
-Also clearplay isn't quite flexible enough, editing out only offensive content.  Some users may want to,
-for example, skip the intro to specific movies (read: older movies with long songs and no content) because...it's deemed boring.  Clearplay 
-does not do that.  Also things skip-worthy include The prefix/endfix of Netflix
-series' that they run together( ex: Dr. Who has 4 episodes in a row, with 4 jarring
-main-title themes between them all.)
+they're all for it (in reality this project is more like in-home cleanflicks than clearplay, anyway) 
+Also clearplay isn't quite flexible enough, editing out only profanity/sex/violence et al (and based
+only on their own criteria).  Some users may want to,
+for example, skip the intro to specific movies (like older movies with long songs and no 
+content during the intro) because...it's deemed boring.  Or skip commercials in some recording.
+Or use it on their home dvd's.  Clearplay does not allow for that.  
+Also clearplay doesn't seem to users for example leave comments on their filters, to improve them, etc.
+
+So overall I wanted to build my own that overcame some of these hurdles, hopefully.
 
 I also wanted to get a prototype out there of some of these ideas so that
-others can't later patent them and pretend that they were first inventors :)
+others can't later patent them and pretend that they were first inventors later :)
+
+See also the "Overly Verbose History" section.
 
 [1] http://www.amazon.com/gp/product/B002YPRW7S/ref=cm_rdp_product
  "...I agree that it is not made clear on their website that if you don't continue your membership, you can't continue 
@@ -129,19 +148,21 @@ others can't later patent them and pretend that they were first inventors :)
 
 == Overly Verbose History ==
 
-It was preceded/inspired by EDL's in the 90's, cleanflicks (both analog and digital ways), 
-zoomplayer's scene-cut editor, http://code.google.com/p/movie-content-editor, the many
-other editors that support EDL for content creation and/or playback, mplayer's EDL's,
-mythtv/XBMC's EDL support, and VLC playlists.  I knew the right elements were ready.
+It was preceded/inspired by EDL's in editors in the 90's, cleanflicks (both analog and digital incantations late 90's), 
+then mplayer began to support EDL, zoomplayer added a scene-cut editor, 
+http://code.google.com/p/movie-content-editor came along, and also many
+other editors have historically supported EDL for content creation and/or playback (see wikipedia's "edit decision list"),
+and also mythtv/XBMC's EDL support (as suggested by the phantom edit [1], oreillynet.com), 
+VLC also added playlists with optional start and stop positions per entry.
+I knew the right elements were ready for sensible cinema.
 
-See also the "related" section.
+See also the "related" section, and "motivation" section.
 
 Originally the project started as a prototype to "watch hulu (online) and netflix instant movies
-edited" (it uses/used screen snap-shotting and tracks, using OCR of the on-screen
-timestamp of the player, monitors it for specific times, and reacts appropriately).
+edited" (it uses/used screen snap-shotting (of specific locations where the digits are, based on windows position) 
+and then tracks, using OCR of the on-screen timestamp of the player, to monitor it for specific times, and react appropriately.
 However, this functionality, though working and available, is disabled currently for potential patent
-issues.
-Some older released versions had it enabled, but not the latest releases.
+issues.  Some older released versions had it enabled, but not the later releases.
 Then I realized I could basically create the same effect using the
 (possibly more patent friendly) pre-processing style, like cutting out bad scenes, like cleanflix did.
 It basically was implementing Edit Decision Lists (EDL's) using playlists and
@@ -155,20 +176,14 @@ realtime tracking, so I included that ability.
 The playlist option is disabled in later releases, as it was deemed too user-non-friendly, because VLC timing
 is "different" than standard DVD players, so I decided to just use standardized timing, though it worked fine
 for VLC playbacks.
+Many releases had built-in support for mplayer's EDL format, but I took it 
+out to concentrate on the cleanflicks side of things.
 
 You can see a full list of other features that have been published and demonstrated
 in the accompanying change_log_with_feature_list.txt.  Each feature works in some released version of sensible-cinema
-though some features are absent in later versions.
+though some features have been removed in later versions.
 
-== License ==
-
-See the included LICENSE.TXT file for licensing and usage terms (basically it's released under gplv3).
-Some other programs are (distributed separately and) leveraged, if present. These are
-typically released under their own copy of the gplv2 license.
-
-All files (c) 2010 Roger Pack
-
-See the accompanied LICENSE.TXT file for more legal information, before using the product.
+[1] http://www.oreillynet.com/sysadmin/blog/2005/06/make_your_own_phantom_edit_wit.html
 
 == Related ==
 
@@ -181,6 +196,7 @@ http://imdb.com tends to have reasonably good lists of what occurs in movies (fi
 Normal movies versus "directors cut" versions of movies (one is at times preferable, profanity wise)
 http://en.wikipedia.org/wiki/Edit_decision_list (it's a linear editing tool, after all--so see the vast list of those)
 Clean Flicks (used to) sell edited movies
+http://www.videoredo.com/en/index.htm lets you "cut out" offensive content (commercials et al) and burn DVD's from mpeg's/h264 streams
 http://www.mplayerhq.hu/DOCS/HTML/en/edl.html
 http://www.oreillynet.com/sysadmin/blog/2005/06/make_your_own_phantom_edit_wit.html (mplayer has had this ability for awhile, with no complaints).
 http://clearplay.com a commercial editing player (tracks DVD's while they play--closed source, costs money, no user contribution possible), and only for DVD's.
@@ -197,7 +213,7 @@ http://forums.gbpvr.com/showthread.php?10606-Automated-Cutting-and-Transcoding-G
 http://www.imdb.com/swiki/special?ParentalGuideHelp (search for "scene description")
 http://www.mythtv.org/wiki/Removing_Commercials
 Using the remote control with the pause, mute, stop, fast forward, and play buttons, along with previous knowledge of scene locations
-The scissors and old VHS tapes (Clean Flicks' origin, if I remember correctly).  http://www.familysafemedia.com/home_movie_editor.html
+The scissors and old VHS tapes (Clean Flicks' origin, if I remember correctly).  http://www.familysafemedia.com/home_movie_editor.html (was a helper kit for cutting VHS tape)
 Windows Movie Maker.  Allows for users to cut and copy scenes of movies to their heart's content.
 http://forum.videolan.org/viewtopic.php?f=7&t=56998 VLC Media Player using EDL's via playlists
 Corel WinDVD has "Quick Clip" settings for capturing from DVD.
@@ -205,7 +221,17 @@ Microsoft's magnified basically copies DVD's screen output if mouse is placed ov
 http://superuser.com/questions/85278/how-can-i-cut-scenes-out-of-a-dvd
 http://blog.josephhall.com/2008/09/command-line-dvd-authoring-part-1.html
 ZoomPlayer MAX's scene cut editor
-anydvd HD's "magic file replacement" for DVD's/blu-ray's
+Anydvd HD's "magic file replacement" for DVD's/blu-ray's
+RiffTrax
+
+== License ==
+
+See the included LICENSE.TXT file for licensing and usage terms (basically it's released under gplv3).
+Some other programs are (distributed separately and) used, if present. These are
+typically released under their own copy of the gplv2 license.
+
+All files are (c) 2010 Roger Pack
+EDL files themselves are released under the Creative Commons License.
 
 == Troubleshooting ==
 
@@ -213,35 +239,35 @@ If you run into some snag, it possibly could have failed in "grabbing" the DVD,
 Try cleaning your DVD and starting over (delete all files, start again). 
 Baking soda toothpaste might help with cleaning it.
 If it still errs, report it, along with a screen snapshot and steps of
-how to reproduce the problem, preferably.  See feedback section.
+how to reproduce the problem, preferably.  See the feedback section.
 
 It can fail also because a deletion is past end of DVD, or 
 Also note that if your DVD has scratches that cause it to skip, the time signatures will be off after that point, 
 so clean your discs and try again!
+"DVDNAV stream read error!"
+  this typically means a dirty or scratched DVD.
 
 Also make sure you aren't out of disk space.
 
-Also you could try a different computer (desktop computers' DVD drives seem to work better at times than laptops')
-
-Also (for power users) make sure your version of ffmpeg is relatively new, as older versions (r19313) is known to crop wrong.
-If you don't know what this means then you're probably ok and don't have to worry about it.
-
-"DVDNAV stream read error!"
-  this typically means a dirty or scratched DVD.
+Also you could try another computer (desktop computers' DVD drives seem to work better at times than laptops')
 
 You try to play back a sensible cinema-ized video file and it plays back without
  audio or video (example: windows media player)?
 
  This probably means you're using windows media player, and don't have "codecs" installed
-   to handle this type of video.  Not to fear, just download the "ffdshow tryouts"
+   to handle this type of audio.  Not to fear, just download the "ffdshow tryouts" (google for it)
    and, when it gives you the option, be sure to check "mpeg2 video" and then
-   it should "just work."  You could also play the file in VLC Media Player or smplayer
-   (there's a button for that).
+   it should "just work."  You could also optionally just play the file in VLC Media Player or smplayer
+   (there's a button for that).  Installing "AC3Filter" may help if you have no audio.
+
+If the picture is too grainy/pixelated or the process is too slow, let me know and I'll work on
+making it better.  No really, I have some ideas, but want to know if there's need first.
 
 == Thanks ==
 
 Thanks to Jarmo for the win32-screenshot gem, the mini_magick gem authors, jruby guys, etc.  
-The combination of these tools made programming this actually something of a pleasure.
+The combination of these tools made programming this actually something of a pleasure, 
+and a breeze cross platform.
 
 == Feedback/Development ==
 
@@ -250,4 +276,14 @@ Feedback, including feature requests, comments, etc. welcome:
 Mailing List: http://groups.google.com/group/sensible-cinema
 
 If you're a developer and want to help out with programmming or look and feel, etc., please do!
-See development.txt / github.com/rdp
+See development.txt / github.com/rdp/sensible-cinema
+
+If you want to donate something, please consider donating to a charity of your choice.  No really.  Do it for this!
+
+== Competition/use of files ==
+
+Note that competition/use of files from sensible cinema is welcome!
+
+In fact, the current end goal is to publish the delete lists (EDL's) as a separate repository, under the creative
+commons license, meaning that even for profit users can use them for whatever other use they want, hopefully
+good uses :)

data/Rakefile

@@ -13,17 +13,20 @@ Jeweler::Tasks.new do |s|
     s.add_dependency 'rdp-win32screenshot', '>= 0.0.7.3' # was 0.8.0 ?
     s.add_dependency 'mini_magick', '>= 3.1' # for ocr...
     s.add_dependency 'whichr', '>= 0.3.6'
-    s.add_dependency 'jruby-win32ole' # LODO take out ...
-    s.add_dependency 'rdp-ruby-wmi'
+    s.add_dependency 'rdp-ruby-wmi' # windows
+    s.add_dependency 'plist' # mac
     s.add_dependency 'ffi' # mouse, etc. needed at least for MRI
-    
+    s.files.exclude '**/*.exe', '**/*.wav', '**/images/*'
     s.add_development_dependency 'hitimes' # now jruby compat!
-    s.add_development_dependency 'rspec' # prefer rspec 2 these days I guess...
+    s.add_development_dependency 'rspec', '> 2'
+    s.add_development_dependency 'jeweler'
+    s.add_development_dependency 'rake'
     
-    # add as real dependencies for now, as gem install --development is still broken for jruby, basically installing transitive dependencies in error
-    for name in ['hitimes', 'rspec', 'jeweler', 'rake']
+    # add as real dependencies for now, as gem install --development is still broken for jruby, basically installing transitive dependencies in error <sigh>
+
+    for gem in s.development_dependencies #['hitimes', 'rspec', 'jeweler', 'rake']
       # bundling rake won't be too expensive, right? and this allows for easier dev setup through gem install
-      s.add_dependency name
+      s.add_dependency gem.name
     end
   end
 
@@ -73,41 +76,25 @@ task 'bundle_dependencies' => 'gemspec' do
    system("rm -rf ../cache.bak")
    system("cp -r vendor/cache ../cache.bak") # for retrieval later
    Dir['vendor/cache/*'].each{|f|
-    unless f =~ /jruby.*jar/ # that one takes too long to download...
-      FileUtils.rm_rf f
-      raise 'unable to delete: ' + f if File.exist?(f)
-    end
+    FileUtils.rm_rf f
+    raise 'unable to delete: ' + f if File.exist?(f)
    }
    FileUtils.mkdir_p 'vendor/cache'
    Dir.chdir 'vendor/cache' do
      dependencies.each{|d|
        system("#{Gem.ruby} -S gem unpack #{d.name}")
      }
-     to_here = "jruby-complete-1.5.5.jar"
-     unless File.exist? to_here
-       url = "/downloads/1.6.1/jruby-complete-1.6.1.jar"
-       puts 'downloading in jruby-complete.jar file '  + url
-       # jruby complete .jar file
-       Net::HTTP.start("jruby.org.s3.amazonaws.com") { |http|
-         resp = http.get(url)
-         puts 'copying jruby complete in... '
-        open(to_here, "wb") { |file|
-           file.write(resp.body)
-        }
-      }
-     end
     
      # create a shunt win32ole file, so that require 'win32ole' will just work.
-     # XXXX may no longer need it...
+     # XXXX may no longer need this...
      Dir.mkdir 'lib'
      File.write('lib/win32ole.rb', 'require "jruby-win32ole"')
-  
-   end # chdir
+   end
   
 end
 
 desc 'create distro zippable dir'
-task 'create_distro_dir' do
+task 'create_distro_dir' => :gemspec do # depends on gemspec...
   raise 'need  bundle_dependencies first' unless File.directory? 'vendor/cache'
   require 'fileutils'
   spec = eval File.read('sensible-cinema.gemspec')
@@ -126,6 +113,7 @@ end
 def cur_ver
   File.read('VERSION').strip
 end
+
 task 'zip' do
   name = 'sensible-cinema-' + cur_ver
   c = "\"c:\\Program Files\\7-Zip\\7z.exe\" a -tzip -r  #{name}.zip #{name}"
@@ -147,16 +135,22 @@ task 'deploy' do
   raise unless system("ssh rdp@ilab1.cs.byu.edu 'ssh wilkboar@freemusicformormons.com \\\"ln -s \\~/www/rogerdpackt28/sensible-cinema/releases/#{name} \\\\~/www/rogerdpackt28/sensible-cinema/releases/latest-sensible-cinema.zip\\\"'")
 end
 
-desc 'j -S rake bundle_dependencies create_distro_dir ... (releases with clean cache dir, which we need now)'
-task 'full_release' => [:bundle_dependencies, :create_distro_dir, :build] do # :release sigh
-  raise unless system("git pull")
-  raise unless system("git push origin master")
+task 'gem_release' do
+  FileUtils.rm_rf 'pkg'
+  Rake::Task["build"].execute
   gems = Dir['pkg/*.gem']
   gems[0..-2].each{|f| File.delete f} # kill old versions...
-  system("#{Gem.ruby} -S gem push #{gems[-1]}")
+  raise unless system("#{Gem.ruby} -S gem push #{gems[-1]}")
   FileUtils.rm_rf 'pkg'
+end
+
+desc 'j -S rake bundle_dependencies create_distro_dir ... (releases with clean cache dir, which we need now)'
+task 'full_release' => [:bundle_dependencies, :create_distro_dir] do # this is :release
+  raise unless system("git pull")
+  raise unless system("git push origin master")
+  Rake::Task["gem_release"].execute
   Rake::Task["zip"].execute
   Rake::Task["deploy"].execute
   system(c = "cp -r ../cache.bak/* vendor/cache")
   system("rm -rf ../cache.bak")
-end
+end