An open source flash player implementation
Clone or download
Permalink
Failed to load latest commit information.
conf fix mingw compilation Feb 3, 2018
debian remove all audio plugins, we now use SDL2_mixer for all platforms Oct 15, 2016
docs/man add command line option to disable rendering Jan 7, 2018
etc/xdg remove all audio plugins, we now use SDL2_mixer for all platforms Oct 15, 2016
i18n Introduce multitexturing for masking Oct 18, 2010
media [media] Remove 20x20 icon, seems to be not needed May 17, 2012
resources Use error messages and IDs from Tamarin Feb 26, 2013
src implement flash.system.Worker/WorkerDomain Sep 16, 2018
tests fix several corner cases for parseInt Jun 17, 2018
tools [langref_parser] fix conversion of file path to class package Sep 2, 2017
.gitignore update .gitignore Jun 9, 2012
CMakeLists.txt use libswresample instead of libavresample, if available Sep 1, 2018
CONTRIBUTING Add initial CONTRIBUTING file Sep 19, 2011
CONTRIBUTORS Add CONTRIBUTORS file Jan 24, 2012
COPYING Added license block to files and GPL-3 license to the repository Apr 2, 2009
COPYING.LESSER Relicense in LGPL3 Jun 4, 2010
ChangeLog implement flash.system.Worker/WorkerDomain Sep 16, 2018
Doxyfile Move all source code into a new src folder May 9, 2011
README remove gtk2 dependency Sep 16, 2017
README.GRAPHICS Rework graphics architecture a bit May 10, 2012
README.tests Improve naive reference counting performance Sep 19, 2012
README.win32 fixes for compiling with MinGW Jul 10, 2016
RELEASING Mention testing in release guidelines Jan 28, 2012
TESTING Add TESTING file for contributors Sep 18, 2011

README

Lightspark is an open source Flash player implementation for playing
files in SWF format. Lightspark can run as a web browser plugin or as
a standalone application.

Lightspark supports SWF files written on the newest version of the
ActionScript language, ActionScript 3.0, which was introduced at the
same time as Flash player 9.

INSTALLATION
============

To compile this software you need to install development packages for
llvm (version 2.8 or >= 3.0), opengl, curl, zlib, libavcodec, libavresample
libglew, pcre, librtmp, cairo, libboost-filesystem, 
sdl2, sdl2_mixer, libjpeg, libavformat, pango, liblzma

If compiling the PPAPI (Chromium) plugin is enabled (on by default), keep in mind that 
it will replace the adobe flash plugin, as only one flash plugin is allowed in chromium. 

Install also cmake, nasm and gcc (version 4.6.0 or newer) or clang

To build the software please follow these steps.

1) cd lightspark
2) mkdir obj
3) cd obj
4) cmake -DCMAKE_BUILD_TYPE=Release ..
5) make
6) sudo make install

DEBUG MODE:
To enable debug mode change the cmake command like this:
4b) cmake -DCMAKE_BUILD_TYPE=Debug

CMAKE_BUILD_TYPE available: Debug LeanDebug Release RelWithDebInfo Profile

EXECUTION
=========

Using `make install`, lightspark is installed in the system wide

Browser plugin
--------------

Firefox plugin path and Firefox should show it in the about:plugins
list and in the Tools->Add-ons->Plugins window.

Lightspark registers itself as the plugin for
application/x-shockwave-flash and for application/x-lightspark, so it
should be recognisable in the about:plugins page. Its description
string is "Shockwave Flash 12.1 r<current version>". The current
version is now "r710".

Firefox is not able to deal very well with multiple plugins for the
same MIME type. If you only see a black box where a flash app should
be try to remove any other flash plugin you have installed.

Command line
------------

The command line version of Lightspark can play a local SWF file.
Execution: lightspark file.swf

Type `lightspark` to see all command line options.

Keyboard shortcuts
------------------

Ctrl+Q Quit (standalone player only)
Ctrl+M Mute/unmute sounds
Ctrl+P Show profiling data
Ctrl+C Copy an error to the clipboard (when Lightspark fails)

SWF SUPPORT
===========

Many web sites do not yet work yet because the implementation is
incomplete. See the following page for support status of selected web
sites: https://github.com/lightspark/lightspark/wiki/Site-Support

You may also try Lightspark on some known-to-work Youtube movies:

http://www.youtube.com/watch?v=ca20NEt4VSQ
http://www.youtube.com/watch?v=4N2YWRJ-ppo
http://www.youtube.com/watch?v=XITHbsUUlYI
http://www.youtube.com/watch?v=-j7c0u9yZ8M
http://www.youtube.com/watch?v=G4S9tV8ZLcE

http://www.youtube.com/watch?v=FatHLHG2uGY

REPORTING BUGS
==============

If you think you have found a bug in Lightspark, please file a bug
report at https://github.com/lightspark/lightspark/issues. See
https://github.com/lightspark/lightspark/wiki/Reporting-Bugs for help
on reporting bugs.