sensible-cinema 0.17.0 → 0.18.0

data/ChangeLog

@@ -1,3 +1,7 @@
+== 0.18.0 ==
+
+Add some home video EDL's, clarify the license(s), use a slightly better video codec, minor bug fixes/refactoring.
+
 == 0.17.0 ==
 
 Grab using a different codec (wish I could grab to the *same* codec)

data/LICENSE.TXT

@@ -0,0 +1,70 @@
+All files (c) Roger Pack 2010
+All files are released under the GPLv3 license [1] unless otherwise specified.  Ping me if you want/need this changed.
+
+May contain 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.
+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, either (the user must install it later).
+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.
+Using sensible-cinema is probably not any 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.
+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).
+
+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: do not redistribute/re-sell edited commercial DVD's.  We have learned from clean flicks that
+redistributing edited commercial DVD's is illegal in the US.  We hope that sensible-cinema
+is more legal, since you can get the DVD's from wherever you want, and it doesn't change their
+structure at all.  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.
+
+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, then later removed).
+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.
+
+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 also that the authors of sensible cinema make no money on the project, nor sell the product. 
+It's distributed free for use for any end users, source code is available (see license section).
+
+YOU MUST AGREE TO THE gplv3 in order to  use this software.
+
+USING THIS SOFTWARE MIGHT BE ILLEGAL IN SOME COUNTRIES 
+
+Please check with your legal advisor, and if this is the case in your country, you are NOT licensed to use this freeware.
+
+[1] http://www.gnu.org/licenses/gpl.html, also gplv3 file.
+[2] http://www.videolan.org/support/faq.html

data/README

@@ -1,27 +1,28 @@
-Sensible-cinema is a program that allows you to apply pre-programmed edit decision lists (i.e. "mute out" 
-or "bleep out" scene lists or skip scenes) for DVD's.
+Sensible-cinema (also known as "paranoid cinema" [inside joke] ) is a program that allows you to apply 
+programmed edit lists (Edit Decision Lists [2]) to DVD's.
+I.e. you can edit a DVD to "mute out" or "bleep out" scenes, or skip them.
 
-An experimental player also works on arbitrary media players like netflix online, vlc, hulu, etc, but is currently disabled.
+It is essentially a linear editor [1] that applies Edit Decision Lists [2] to videos, by wrapping
+a few freely available open source (GPL) programs [3] (VLC Media Player, Mplayer/mencoder, ffmpeg et al)
+to accomplish the editing.
 
-It is basically a linear editor [1] that applies Edit Decision Lists [2] to videos, by wrapping
-a few freely available open source (GPL) programs [2].
+To use it, basically install then run it (see below).
+It will come up with some windows where you choose what you want to do
+(edit an edit list, use an edit decision list to edit a DVD, etc.)
+
+Enjoy!
 
 [1] http://en.wikipedia.org/wiki/Linear_video_editing
 [2] http://en.wikipedia.org/wiki/Edit_decision_list
 [3] http://www.gnu.org/licenses/
 
-To use it, basically install it, then run it. It will come up with some windows where you choose what to do
-(edit a list, apply a list to a DVD, etc.)
-
 == Installation ==
 
-download the latest .zip version file from: http://rogerdpack.t28.net/sensible-cinema/
-unzip it (right click -> Extract all)
-"click into it" and search for and start the file "run sensible cinema.bat"
+To install, download the latest .zip versioned file from: http://rogerdpack.t28.net/sensible-cinema/
+then unzip it (right click -> Extract all)
+then "click into it" and search for and run the file "run sensible cinema.bat"
 
-Note that you'll need java previously installed for it to work, but chances are you already have it.
-
-== Creating Your Own List ==
+== Creating Your Own Edit Lists, or modifying previously existing ones ==
 
 You create an edit decision list for sensible cinema to use against whatever you want.
 
@@ -34,19 +35,19 @@ https://github.com/rdp/sensible-cinema/blob/master/zamples/edit_decision_lists/e
 Basically your job is to create an appropriate file (like that one) somewhere, 
 then start sensible-cinema and instruct it to use your new file.
 
-Once you're done then you can contribute your scene descriptions file if desired, back to the project itself [1].
-
-[1] submit an issue: http://github.com/rdp/sensible-cinema/issues
+Once you're done then you can contribute your scene descriptions file if desired, back to the project itself (see the "feedback" section,
+below).
 
 == FAQ ==
 
-Q. How do I watch these on my TV?
-A. You can burn a DVD with it.  First create it on your hard drive.  Then use
-  Dvd Flick ()a good one for windows) (here's a screencast of using it within http://rogerdpack.t28.net/sensible-cinema)
+Q. How do I watch these on my TV, not just on my computer?
+A. You could burn a new DVD with it.  First create it on your hard drive.  Then use some burning utility.
+  Dvd Flick is a good one for windows.  Heere's a screencast of using it: http://rogerdpack.t28.net/sensible-cinema
   For OS X : iDVD might work well.
-  You could also drag your laptop over to your TV and hook it in that way.  Or buy a very long cord and plug it in as an extra monitor.
+  You might be able to move your laptop over to near your TV and hook it in from there.  
+  Or buy a very long cord and plug it in as an extra monitor from your desktop.
   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 eventually help.
+  something in mind that could help, though hasn't been created yet.
 
 == Caveats ==
 
@@ -56,22 +57,74 @@ you could employ somebody to create it, or create it yourself.  Make sure to sub
 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.
 
+Also note that if your DVD has scratches that cause it to skip, the time signatures will be off, so clean your discs!
+
+== Motivation ==
+
+The initial motivation for the project was that I dislike profanity in movies.
+It's jarring, if you're not used to it in real life.
+Also sometimes certain scenes in movies offend, and don't contribute to the overall plot,
+and I'd rather not watch a movie that has them.
+Clearplay (a realtime filtering DVD player)
+(for me) didn't cut it.  It costs (I'm too cheap to pay--and many
+many other people don't/can't use it...).  Their
+filters sometimes don't cut out all unwanted content (ex: Saints and
+Soldiers left profanity in its filtered version...which wasn't what I had
+anticipated.  Others have noted that sometimes the edit timings
+are off so that it will mute out sections just previous to the profanity, while
+leaving the profanity in, etc.).  Also clearplay apparently runs a rather 
+confusing subscription policy, as well, so I'm told [1].
+Also sometimes clearplay "mutes out" profanity but you can easily still lip read it,
+so it's almost as if you were exposed to it anyway.  Not ideal.
+There is no little community collaboration/review.
+They don't even have a "request a filter" option anymore.
+They don't have filters for movies that I want edited (Condorman and Tron
+lacked last time I checked...probably because they are too
+obscure.) Also I watch movies only on computer, and they no
+longer have a computer player.  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 and was
+also more accessible/open.
+
+I also wanted to get a prototype out there of some ideas so that
+people can't patent them and pretend that they were inventors :)
+
+So the project started off as a prototype that could "watch hulu (online) movies
+edited" (it uses screen tracking and OCR's the on-screen
+timestamp, monitors it for specific times, and reacts appropriately).
+However, I do not currently release that version to the public for patent
+reasons (clearplay has a patent on realtime tracking,
+which is similar).  I have released older versions that do, but not
+anymore.
+Then I realized I could basically have the same effect by using
+pre-processing and Edit Decision Lists (basically by using playlists with
+VLC, to play from second x to y, then from x to mu, etc.).
+I just pass in a playlist, it does all the work for me.
+There are a few released versions that do this exactly.
+Then it occurred to me that you could grab the several clean segments
+off a DVD, and piece them together to create an edited copy.  This avoids 
+realtime tracking.  Which is where we are now.
+
+See also the LICENSE.TXT file.
+
+[1] http://www.amazon.com/review/R27VK5BR9NDHBD/ref=cm_cr_pr_viewpnt#R27VK5BR9NDHBD
+
 == License ==
 
-See the included LICENSE file for licensing, usage terms (basically gplv3 for all the source).
-Some other programs are (distributed separately and) called by this one, typically under the gplv2.
+See the included LICENSE file for licensing and usage terms (basically it's under gplv3 for all the source).
+Some other programs are (distributed separately and) used by this one, typically they are under the gplv2 license.
 
 All files (c) 2010 Roger Pack
 
 == Related ==
 
-The concept isn't too novel.  Some earlier examples:
+The concept isn't too novel.  Some other previously existing examples:
 
 Edited "airplane edit" style movies.
 Commercial TV (ABC, NBC) show their own (edited) movies.
 http://en.wikipedia.org/wiki/Linear_video_editing
 http://imdb.com tends to have reasonably good lists of what occurs in movies (find a movie, click on "parent's guide" on the left).  Sometimes it even lists the time signatures for events (ex: "Labyrinth" http://www.imdb.com/title/tt0091369/parentalguide) which you could use to translate into a sensible-cinema compatible list.
-Normal movies versus "directors cut" versions of movies (one is at times preferable)
+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.mplayerhq.hu/DOCS/HTML/en/edl.html
@@ -87,16 +140,29 @@ http://code.google.com/p/movie-content-editor (written in Python, controls VLC b
 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, BTW).
+The scissors and old VHS tapes (Clean Flicks' origin, if I remember correctly).
 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 on DVD.
+Corel WinDVD has "Quick Clip" settings for capturing from DVD.
 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
 
+== Troubleshooting ==
+
+Note that you'll need java previously installed for this to work.  You probably already do though.
+If you run into a snag, try cleaning your DVD. Baking soda toothpaste might help.
+If it still errs, report it to the authors, along with a screen snapshot and steps of
+how to reproduce the problem, preferably.  See feedback section.
+
+If it says "audio problem try pcm" then you can add
+"audio_codec" => "lavc"
+to your EDL and try again.
+
 == Feedback ==
 
 Feedback, including feature requests, comments, etc. welcome.
 
 http://github.com/rdp/sensible-cinema (message me or create an issue for feedback/any requests/bugs)
-or rogerdpack@gmail.com
+or e-mail rogerdpack@gmail.com
+If you're a developer and want to help out with programmming it, please do!
+Also ping me if you want a mailing list created or what not.

data/TODO

@@ -1,85 +1,99 @@
 == medium ==
   
-== probably next up+low prio ==
+== up next release ==
 
-== slightly lower than that ==
+  realtime
+    mplayer EDL...
+      test...
+  
+  simplify/de-bugify
+  
+    that button shows up? (issue 10)
+    
+    EDL for blender movie...
+    re-run latest preview -> auto play in smplayer
+    move that one button *out* ...
+    only pick a drive once per session
+  only pick output filename once per session...
+  
+calculating disk's unique id...
+F:\, Roger's Wedding, a2e3ece630251e4a785218ce71a20ce1
+got fatal exception
+D:\dev\sensible-cinema-never-commit-from-here\zamples\edit_decision_lists\dvds/pack_wedding_2007-03-03.txt:12: syntax error, unexpected tSTRING_BEG
+
+"disk_unique_id" => "a2e3ece630251e4a785218ce71a20ce1",
+^
+D:\dev\sensible-cinema-never-commit-from-here\zamples\edit_decision_lists\dvds/pack_wedding_2007-03-03.txt:1:in `parse_string'
+  during "initial create rip" can watch it (unedited) while it's still ripping (mplayer)
+  
+  assert that at least one drive has a DVD in it...maybe loop refuse with message until this?
+  disallow choosing empty drive? fail cleaner? (issue 11)
+
+
+== slightly lower than that, somewhat ordered ==
 
-  Harry Potter audio!
-  re-run latest preview -> play in smplayer
-  license required first time they run it (gplv3)
+  compare computer DVD timings with physical player...
+  
+  mpeg is lossy (at least my current one pass one is)
+    could check if DVD Flick handles *oversize* files well, for information sake 
+    check it against cool runnings...
+      on the big screen...does raw.mpg look normal there? fulli?
+        if so, then program the "frame accurate" cutter
   partner for filters (Jon, Karlie if interested...give beta)
     lotsa filters somehow
       my dvd's (loose timestamps...)
       partners'...
   beta release/rinse and repeat with various ppl (once it's releasable...)
   a real'ish-er website
-  checkbox for all other licenses or something?
-  compare computer DVD playback with physical player...
-  program the temple thing with it
-    note such "I first use this to edit my temple movie"
-  Andrew's e-mail
+  play a bigger noise when totally done...(dvd flick'ish...)
+  note that this can corrupt your soul!
+    don't watch it if it's dark! come on!
+  does ffdshow let WMP playback the audio on those files?
 
-== DVD backlog (unordered, some very low prio) ==
+== DVD backlog (unordered, some very low prio, basically never do) ==
 
-  60 fps?
+  can pull from imdb at package time [?]
+  delete fulli file
+    except if it's a specific scene run...
+  bundle 7z [?]
+   if license agreement allows
+   thinking not though...
+  bundle rubyzip
+  create wiki ("next to" distributed EDL's?)
+  mencoder harddup useful?
+  .exe installer, just unzips, runs the .bat file for them [?] :)
+  create a forum
   ask if you can somehow more grab to the *same* codec (ffmpeg, mencoder mailing lists)
-  allowing for torn discs:
-    does VLC as a ripper even make sense in these cases? (as "just a ripper")?
-    try baking sode tooth paste...
   split EDL's somehow into their own project/LLC...
-  add md5 "warning" when a disc fails doesn't match because of read failure...
+  add md5 "warning" when something (anything) had failed disc fails doesn't match because of read failure...
   not loop on preview view (smplayer)
-  note SSD or perhaps tons of RAM help with speed :)
-  only pick that filename once per session...
-  overlay audio
-  assert that at least one drive has a DVD in it...maybe loop refuse with message until this?
-  cool runnings:
-     make a copy me--do they now match?
-     get a working copy--do they match?
-  md5sum the full rip files...
-    is it necessary?
-      yes? add button for md5sum
   propaganda-ize
+    advertise in christian places
     alternative.to
     blogs that have ever mentioned clearplay :P
-  play a bigger noise when totally done...(dvd flick has one...)
-  vnc has a good looking license :)
-  unzip instructions?
-  prompt for name, auto populate with volume name
   LLC before ever pay anyone, if I ever do
-  redo the creation mode buttons into an ordering of sorts...
-  note that this can corrupt your soul!
-    don't watch it if it's dark! come on!
-  figure out if mplayer/smplayer as a player has a fast forward feature...
+  @DVD flick: support multi-track audio/subtitles (if they're already in the streams...)
+  note the mplayer/smplayer as a player fast forward feature...
   several "play now" options...without a navigator of course :)
     visualbasic-like playlist
       one line at a time :P
-      provide link for cheap DVD decoder :)
+      provide link for cheap DVD decoder if absent [ffdshow?] :)
     "round conservatively, write no file" playback
       mplayer batch (playlist?)
     can generate mplayer EDL's and play them...hmm...smplayer them?
-      update license too...
     "round conservatively, yes write file"
-      then I guess they could play it back?
+      then I guess they could play it back immediately...?
     get half-way through (rip, start writing edited copy), then start playing back as writing edited full copy
     one that's "play DVD to x, now play it muted, now play it to y" (playlist? batch?)
       one for watch unedited "as grabbing" (in create mode)
       can I do this super accurately anyway, more easily?
-    one that's "rip and save first 20 minutes, start me on that, do the whole thing..."
-  finalize my google doc on rippers et al.  
-  non parallelize
-    can have different volume settings
-    can insert other sections (same disk) mid-stream :P
-      these last two have gotta be lower prio than the rest...
+    one that's "rip and save first 20 minutes edited, start me on that, do the whole thing..." [?]
+      except after 20 minutes you're hosed
+    some super spiffy version that can grab and play "both" *on the fly* somehow LOL
+      maybe one that is watching the extraction (get info, get info, get info...)...as it includes scene x, it adds it edited to the end of the final output file...
+        This seems like the only real way.
+    one that's "we're ripping, but play from that via EDL or playlist"
   whichr: return nil
-  install smplayer before mencoder [?]
-  smaller .zip
-  bundle 7z [?]
-   remove note about it
-  using, burning, creating  "howto's"
-   better
-    usability test them?
-    umm...shouldn't using be pretty straight forward tho?
     
  using+burning screencast
  editing screencast
@@ -102,9 +116,10 @@
   check all the many options to see if there's a "cross platform way to split files accurately" besides my hacky kludge.
   can rip from a DVD-like local folder (would anybody ever need this?)
   ripping "redoes" a large last section, for combining. Can I avoid this?
-    plus I do some copy, some ac3?
-@dvd flick do you need that frequent of i-frames?
+    plus I do some copy, some ac3 audio codec? huh? avoidable?
+  @dvd flick do you need that frequent of i-frames?
   rename bat as template.bat
+  add a developer readme
   can parse IMDB (require they put in the URL by hand fer now)
     add stuffs to imdb hmmm
     IMDB easy mapping
@@ -134,6 +149,8 @@ make the progress bar map "better" to the actual time that each section should t
 Note to people: make several EDL's per movie.
 Note to people: clean your disks!
 
+@mencoder: cannot rip from dvd with -ovc copy -oac copy (tearing)
+
 burnable to DVD/CD/multi DVD automagically... (auto-burn insert your new disk!)
     can *re-use* original navigation stuffs, less the profanity (is that possible? VobBlanker help, perhaps?)
   can lop off sections to save space (?)
@@ -145,33 +162,30 @@ try to compile transcode in cygwin (yipes)
 legal shtuff (LICENSE)
 
 @smplayer: right click on DVD...
-
-== random non-DVD (or don't care when) backlog ... note: just plow forward, to "grab" available ideas...except that for now, just what *I* plan on needing for myself (filters for what I need/want). ==
-
-the ac3 thing
+the ac3 thing (I have to specify it...is this necessary? is it always ac3?)
+can have different volume settings
 ask VLC "fuzzy menus on the happiest baby dvd expected?"
 right click on DVD player, rip edited with SC?
-auto-zip it with my rake task :)
-split the two projects somehow (project + distribution)
-    two releases: experimental, developer/experimental
-    bring back the old :)    
-button for "suck in EDL's"
- split out the EDL's to a separate project (?)
-make the other stuff work again, since I no longer use YAML...
-advertise my "splitting joining" google doc page. also test the various options there for accurateness :)
-also note that mencoder doesn't do splitting very well, for some reason.
-
-pass unit tests again jruby
-
 @mplayer and VLC "you should seek better, like the ogg vorbis fellas recommend..."
 report to jruby "when one thread dies, the GUI becomes unresponsive" (and others already previously reported to ruby-forum.com...)
   DVD's (right click on DVD player, play with SC?)
     use spiffy differentiation for DVD's on windows
+a "certified clean" list
+advertise my "splitting joining" google doc page. also test the various options there for accurateness :)
+check for "newer version available" or not...
+buy blu-ray decrypter, try it out.
+
+== random non-DVD backlog ... note: just plow forward, to "grab" available ideas...except that for now, just what *I* plan on needing for myself (filters for what I need/want). ==
+
+fade in/fade out volume, video
+make the other stuff work again, since I no longer use YAML...
+
+pass unit tests again jruby
+
 speed up slow unit tests
 can "watch as it is being ripped" (concat, watching it as it grows faster than you watch...)
 make the overlay window uncloseable (?)
-note that youtube "can" be downloaded then a local edited copy created, from that download. (mb add downloading ability?)
-a "certified clean" list (?)
+note that youtube can be downloaded then a local edited copy created, from that download. (mb add downloading ability?)
 screencast of things helpful (use, creation...).
 tune up the levels...
 prototypes of the experimental stuff (overlay, track time while recording -> map file, specifiable levels, more?)