content-editing-movie-player 0.38.0

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "lib/jruby-swing-helpers"]
+	path = lib/jruby-swing-helpers
+	url = https://github.com/rdp/jruby-swing-helpers.git

data/.rvmrc

@@ -0,0 +1 @@
+rvm use jruby

data/LICENSE.TXT

@@ -0,0 +1,20 @@
+All files (c) Roger Pack 2010-2011
+
+All files released under the GPLv3 license [1] unless otherwise specified.  Ping me if you want/need this changed at some point.
+
+EDL (delete list/edit list/EDL) files are released under the Creative Commons License, however.
+
+Note: may call out to some 3rd party libraries/executables under their own (separate, open source) licenses and distributions, but they are contained
+packaged for convenience.  They have their own source codes available.
+
+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.
+
+Ffmpeg is included, under the GPLv2: http://www.ffmpeg.org/legal.html http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
+
+unzip.exe is herein included, under the info-zip license: http://www.info-zip.org/license.html
+
+Some binary builds of dvdid are also distributed here.  See http://www.srcf.ucam.org/~cjk32/dvdid (in an email he said he'd release them under a BSD or other permissive type license)
+
+TsMuxer binaries are included, with their own license, see vendor/tsmuxer1.10.6/licence.txt (it allows for redistribution).
+
+See first also the file "documentation/is_it_legal_to_copy_dvds.txt" for more information on legal implications in your country.

data/README.TXT

@@ -0,0 +1,225 @@
+This is a README description for the Clean Editing Movie Player
+
+For installation/download instructions, see http://rogerdpack.t28.net/sensible-cinema
+
+===
+
+CEM Player allows you to use pre-programmed edit lists
+(e.g. Edit Decision Lists [2]) to watch movies that you own.  
+I.e. you can watch a DVD while "muting out" or skip certain scenes, deemed objectionable.
+This allows you to sit back and relax as you watch a more "sanitized" showing of your DVD.
+
+It is currently in alpha/beta, and is free (probably both forever, gplv3 license currently).
+It also includes a library of EDL's that go along with various DVD's.  We need volunteers/contributors
+to help it grow!
+
+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 (watch edited, create a new EDL file, etc.).
+
+Note: please install from the zip files at https://sourceforge.net/projects/sensible-cinema/files/ 
+and not from github's "download" button.
+
+CEM Player has a few "realtime viewing" options available, based on some freely available
+open source popular video players [3].
+
+On a more moral note, just because an edited video lacks profanity/sex scenes...does not 
+automatically make it a wholesome experience.
+CEM Player does not necessarily "a clean movie make of a dirty one" even if it can cut profanity.  
+Don't watch it if it's not uplifting! Be nice to yourself!
+
+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, and doesn't allow for community
+contribution.  Hence this project existing.
+
+That being said, some videos are quite enjoyable once you strip out profanity/questionable content.
+It's your call.
+
+Enjoy your movies!
+
+[1] http://en.wikipedia.org/wiki/Linear_video_editing
+[2] http://www.mplayerhq.hu/DOCS/HTML/en/edl.html and 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"
+
+== Installation ==
+
+Installation and usage instructions available here: http://rogerdpack.t28.net/sensible-cinema
+NB that you want to download it sourceforge, not from github downloads.
+
+== Creating Your Own Edit Lists, or modifying previously existing ones ==
+
+Sometimes the movie you want doesn't have an EDL (edit list) available for it yet.
+Not to worry, you can create your own!
+See https://github.com/rdp/sensible-cinema/wiki/How-to-create-your-own-EDL's
+
+== Feedback/Contributing to Development ==
+
+Feedback, including feature requests, comments, etc. all welcome:
+
+See website: http://cleaneditingmovieplayet.inet2.org contact section
+
+If you're a developer and want to help out with programmming or look and feel, etc., please do!
+See notes_for_potential_developers.txt file, and also http://github.com/rdp/sensible-cinema for source, and/or
+the wiki there.
+
+If you want to donate something, please consider donating to a charity of your choice.  
+No really, feel free, go ahead.
+
+== FAQ ==
+
+Q. How do I watch these on my TV, not just on my computer?
+A. One way is to plug your computer into your TV.
+  For instance, position a laptop near your TV and hook it in.  Newer TV's support this.
+  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 computer/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 the existing one costs money).
+  You may be able to create your own edited version of a DVD, see section "Creating an edited DVD"
+  Another good option is to purchase and use a clearplay player, with accompanying subscription.
+  
+Q. I want to give an edited DVD to a friend, how do I do that well?
+A. Give them the original, non-edited DVD and then give them a link to sensible-cinema's website :)
+
+Q. Can I use this with Windows Media Center?
+A. Yes, just use some WMC plugin that allows you to "call out" to a 3rd party software to play your files.
+   Then use the "advanced" mode "create side-by-side EDL file" to create an EDL for your previously existing file.
+   Then make your WMC plugin "call out" to smplayer to play those files (through whatever means it necessary), and
+   it will automatically pick up and use the EDL file.
+   You could also use the same side-by-side EDL file with XBMC, which also honors them (need at least an Eden release version).
+
+Q. Is it unethical to watch edited movies?
+  Well, producers have been making "airplane edited" movies forever, why should this offend them? :)
+  http://en.wikipedia.org/wiki/Re-edited_film
+  But anyway if you don't find it ethical, then do yourself a favor don't watch them.
+
+Q. Can I know if movies in the theaters have profanity in them?
+A. You can--you can download their subtitle file, then use the "part subtitle" button to tell if even movies
+   *in the theater* have profanity (this won't help you skip that profanity, obviously, if you go to see it, but it's
+   a heads up).  Kids-in-mind.com and common sense media reviews are helpful, as well, though sometimes they miss
+   profanity words, one or two.
+
+== Caveats ==
+
+NB that "someone" has to first create a edit list, per DVD.
+If one doesn't yet exist for the DVD you want edited,
+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 edit 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 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 me a bit on edge when I watch an otherwise enjoyable 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 more movies :)
+
+I once tried Clearplay (a "filter"ed DVD player)
+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...).  Casual users no longer have the
+option to buy specific "filters" but are obliged to purchase a monthly subscription,
+so it doesn't make sense financially for many casual movie viewers.
+For instance, if you use redbox every week, and then have to subscribe to clearplay,
+it could triple your total cost.
+Their filters sometimes don't cut out all undesired content (ex: Saints and
+Soldiers left several profanities in...which was unexpected).
+If your standards differ from theirs, I guess you're out of luck.  
+Clearplay apparently also runs a rather 
+confusing subscription policy, or so I'm told [1], and their DVD players that 
+are a bit shaky at times [2], so I'm told.  Their DVD players aren't quite as readily accessible (read: 
+can't buy them at walmart), nor as cheap to buy as some others.
+Clearplay also doesn't seem to have much community collaboration/review (though you can email them feedback).
+They also did't have filters for all movies that I, at times, wanted to watch edited (Condorman and Tron
+lacking last time I checked...probably because they were too
+obscure.  Also it doesn't have filters for educational videos, etc.) 
+If there isn't a filter, you basically have to request one and then *hope* they get around to it.
+It might take a bit longer than you'd hope (read: years). Or it might never be made.
+Also, some people watch movies only on computer, and they
+no longer seem to offer a computer player, just hardware players.  They also don't edit streamed
+online movies either (last time I checked, anyway), nor offer an edited 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 (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's to specific movies (like older movies with long songs and no 
+content during the intro) because...they want to get to the movie faster.  
+Or skip commercials in some personal DVD recording.
+Or use it on their home dvd's.  Clearplay does not allow for any of these.  
+Also clearplay doesn't seem to users for example leave comments on their filters, to improve them, etc.
+Also you can't tell from clearplay's list whether a DVD is absent because it's clean, or because they
+haven't done a filter for it.
+Also sometimes certain DVD's "don't work" with clearplay for some reason (rental versions?) [3]
+As a friend once said "Clearplay is a bit of a hassle to use in today's day and age.
+It should either have wireless or an ethernet port on it. I should
+enter my login credentials to the box. When I stick a move in, it
+should go to the website and download the filter."
+
+So overall I wanted to build my own that overcame some of these hurdles.
+
+I also wanted to get a prototype out there of some ideas so that
+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 
+  to use the [previously downloaded] filters"
+
+[2] http://deseretbook.com/ClearPlay-HDMI-DVD-Player-30-Day-Trial-Membership/i/5038491
+ "We bought a clearplay player about 2 years ago. It worked great, until it just stopped working. I called their support line, 
+  and they told us the model we got was defective, and that the new one was much better and we could get it at a discount, but 
+  the next one just died also."
+
+[3] http://blog.clearplay.com/2010/02/time-travelers-wife.html comments
+
+== History ==
+
+See the file history_and_related_works_list.txt for an overly verbose history.
+Also see the file change_log_with_feature_list.txt.
+
+== Related Works ==
+
+See the file history_and_related_works_list.txt
+
+== 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, though some have differing licenses.
+
+EDL files themselves are released under the Creative Commons License, however.
+See first also the file "is_it_legal_to_copy_dvds.txt" for more information on legal use in your country.
+
+== Troubleshooting ==
+
+See the file documentation/troubleshooting.txt, or contact (see the feedback/development section).
+
+== 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, 
+and a breeze cross platform.
+CEM Player leverages code from lots of other projects (see LICENSE.TXT)--many thanks to 
+the authors and maintainers of said libraries, and anybody else I forgot to mention.
+CEM Player also includes a conglomeration of the good ideas from several people who contacted me
+over time.  Thanks for your contributions.
+
+== Competition/re-use of files ==
+
+Note that competition/use of files from sensible cinema is welcome!
+
+In fact, the current end goal is to publish the edit lists (EDL's) to a separate repository with its
+own API under the CC license, meaning that even "for profit" users can use them for whatever other use they want, hopefully
+good uses :)  More direct direct competitors are also welcome here.  I only made this because I had to
+and nothing like it existed, so if something else springs up, I'm actually happy to use it instead, too.

data/Rakefile

@@ -0,0 +1,206 @@
+require 'rubygems'
+require 'jeweler' # gem
+require 'os' # gem
+
+ENV['PATH'] = "C:\\Program Files (x86)\\Git\\cmd;" + ENV['PATH'] # for jeweler's git gem hackaround...
+
+Jeweler::Tasks.new do |s|
+    s.name = "content-editing-movie-player"
+    s.summary = "an EDL scene-skipper/bleeper that works with DVD's and files and online players like netflix instant"
+    s.email = "rogerdpack@gmail.com"
+    s.homepage = "http://github.com/rdp"
+    s.authors = ["Roger Pack"]
+    
+    # IF CHANGED PUBLISH NEW GEM [and delete pkg] :)
+    s.add_dependency 'os', '>= 0.9.4'
+    s.add_dependency 'sane', '>= 0.25.4'
+    s.add_dependency 'rdp-win32screenshot', '= 0.0.9'
+    s.add_dependency 'mini_magick', '>= 3.1' # for ocr...
+    s.add_dependency 'whichr', '>= 0.3.6'
+    s.add_dependency 'rdp-rautomation', '> 0.6.3' # LODO use mainline with next release, though I can't remember why
+    s.add_dependency 'rdp-ruby-wmi' # for windows
+    s.add_dependency 'plist' # for mac
+    s.add_dependency 'jruby-win32ole' # jruby-complete.jar doesn't include windows specifics...
+    s.add_dependency 'ffi' # mouse, etc. needed for windows MRI, probably jruby too [windows]
+    s.files.exclude '**/*.exe', '**/*.wav', '**/images/*', 'vendor/*'
+    s.add_development_dependency 'hitimes' # now jruby compat!
+    s.add_development_dependency 'rspec', '> 2'
+    s.add_development_dependency 'jeweler'
+    s.add_development_dependency 'rake'
+    if ENV['for_gem_release']
+      # add as real dependencies for now, as gem install --development is still broken https://github.com/rubygems/rubygems/issues/309
+      for gem in s.development_dependencies #['hitimes', 'rspec', 'jeweler', 'rake']
+        s.add_dependency gem.name, gem.requirement
+     end  
+   end
+end
+
+desc 'run all specs'
+task 'spec' do
+  failed = []
+  Dir.chdir 'spec' do
+    for file in Dir['*spec*.rb'] do
+      puts "Running " + file
+      if !system(OS.ruby_bin + " " + file)
+        failed << file
+      end
+    end
+  end
+  if failed.length == 0
+    p 'all specs passed!' 
+  else
+    p 'at least one spec failed!', failed
+  end
+    
+end
+
+def get_transitive_dependencies dependencies
+  new_dependencies = []
+  dependencies.each{|d|
+   gem d.name # make sure it's loaded so that it'll be in Gem.loaded_specs
+   begin 
+     dependency_spec = Gem.loaded_specs.select{|name, spec| name == d.name}[0][1]
+   rescue
+     raise 'possibly dont have that gem are you running jruby for sure?' + d.name +  Gem.loaded_specs.select{|name, spec| name}.inspect
+   end
+   transitive_deps = dependency_spec.runtime_dependencies
+   new_dependencies << transitive_deps
+  }
+  new_dependencies.flatten.uniq
+end
+
+desc 'clear_and_copy_vendor_cache'
+task 'clear_and_copy_vendor_cache' do
+   FileUtils.rm_rf "../cache.bak"
+   system("cp -r vendor/cache ../cache.bak") # so we can retrieve it back later
+   Dir['vendor/cache/*'].each{|f|
+    FileUtils.rm_rf f
+    raise 'unable to delete: ' + f if File.exist?(f)
+   }
+end
+
+def read_spec
+ eval File.read('content-editing-movie-player.gemspec')
+end
+
+desc 'collect binary and gem deps for distribution'
+task 'rebundle_copy_in_dependencies' => 'gemspec' do
+   spec = read_spec
+   dependencies = spec.runtime_dependencies
+   dependencies = (dependencies + get_transitive_dependencies(dependencies)).uniq
+   FileUtils.mkdir_p 'vendor/cache'
+   Dir.chdir 'vendor/cache' do
+     dependencies.each{|d|
+       system("#{OS.ruby_bin} -S gem unpack #{d.name}")
+     }
+   end
+end
+
+desc 'create distro zippable dir'
+task 'create_distro_dir' => :gemspec do # depends on gemspec...
+  raise 'need rebundle deps first' unless File.directory? 'vendor/cache'
+  require 'fileutils'
+  spec = read_spec
+  dir_out = spec.name + "-" + spec.version.version + '/cem-player'
+  old_glob = spec.name + '-*'
+  FileUtils.rm_rf Dir[old_glob] # remove any old versions' distro files
+  raise 'unable to delete...' if Dir[old_glob].length > 0
+  
+  existing = Dir['*']
+  FileUtils.mkdir_p dir_out
+  FileUtils.cp_r(existing, dir_out) # copies files, subdirs in
+  # these belong in the parent dir, by themselves.
+  root_distro =  "#{dir_out}/.."
+  FileUtils.cp_r(dir_out + '/template_bats/mac', root_distro) # the executable bit carries through somehow..
+  FileUtils.cp_r(dir_out + '/template_bats/pc', root_distro) # the executable bit carries through somehow..
+  FileUtils.cp(dir_out + '/template_bats/RUN SENSIBLE CINEMA CLICK HERE WINDOWS.bat', root_distro)
+  FileUtils.cp('template_bats/README_DISTRO.TXT', root_distro)
+  p 'created (still need to zips it) ' + dir_out
+  FileUtils.rm_rf Dir[dir_out + '/**/{spec}'] # don't need to distribute those..save 3M!
+end
+
+def cur_ver
+  File.read('VERSION').strip
+end
+
+def delete_now_packaged_dir name
+  FileUtils.rm_rf name
+end
+
+desc 'create *.zip,tgz'
+task 'zip' do
+  name = 'cem-player-' + cur_ver
+  raise 'doesnt exist yet to zip?' unless File.directory? name
+  if OS.doze?
+    raise 'please distro from linux only so we can get mac distros too'
+  else
+    sys "zip -r #{name}.zip #{name}"
+  end
+  sys "tar -cvzf #{name}.mac-os-x.tgz #{name}"
+  delete_now_packaged_dir name
+  p 'created ' + name + '.zip,tgz and also deleted its [create from] folder'
+end
+
+def sys arg, failing_is_ok = false
+ 3.times { |n|
+  if n > 0
+    p 'retrying ' + arg
+  end
+  if system arg
+    return
+  end
+ }
+ raise arg + ' failed 3x!' unless failing_is_ok
+end
+
+desc 'deploy to sourceforge, after zipping'
+task 'deploy' do
+  p 'creating sf shell'
+  sys "ssh rdp@ilab1.cs.byu.edu 'ssh rogerdpack,sensible-cinema@shell.sourceforge.net create'" # needed for the next command to be able to work [weird]
+  p 'creating sf dir'
+  sys "ssh rdp@ilab1.cs.byu.edu 'ssh rogerdpack,sensible-cinema@shell.sourceforge.net \"mkdir /home/frs/project/s/se/sensible-cinema/#{cur_ver}\"'", true
+  for suffix in [ '.zip', '.mac-os-x.tgz']
+    name = 'cem-player-' + cur_ver + suffix
+    if File.exist? name
+      p 'copying to ilab ' + name
+      sys "scp #{name} rdp@ilab1.cs.byu.edu:~/incoming"
+      p 'copying into sf from ilab ' + name
+      sys "ssh rdp@ilab1.cs.byu.edu 'scp ~/incoming/#{name} rogerdpack,sensible-cinema@frs.sourceforge.net:/home/frs/project/s/se/sensible-cinema/#{cur_ver}/#{name}'"
+    else
+      p 'not copying:' + name
+    end
+  end
+  p 'successfully deployed to sf! ' + cur_ver
+end
+
+# task 'gem_release' do
+#   FileUtils.rm_rf 'pkg'
+#   Rake::Task["build"].execute
+#   sys("#{Gem.ruby} -S gem push pkg/content-editing-movie-player-#{cur_ver}.gem")
+#   FileUtils.rm_rf 'pkg'
+# end
+
+def on_wbo command
+  sys "ssh rdp@ilab1.cs.byu.edu \"ssh wilkboar@rogerdpack.t28.net '#{command}' \""
+  
+end
+
+desc 'sync wbo website'
+task 'sync_wbo_website' do
+  on_wbo 'cd ~/sensible-cinema/source && git pull'
+end
+
+desc ' (releases with clean cache dir, which we need now)'
+task 'full_release' => [:clear_and_copy_vendor_cache, :rebundle_copy_in_dependencies, :create_distro_dir] do # this is :release
+  p 'remember to run all the specs!! Have any!'
+  require 'os'
+  raise 'need jruby' unless OS.jruby?
+  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
+  Rake::Task["sync_wbo_website"].execute
+  system(c = "cp -r ../cache.bak/* vendor/cache")
+  system("rm -rf ../cache.bak")
+end