An open source flash player implementation
C++ C ActionScript CMake Shell Assembly Other
Permalink
Failed to load latest commit information.
conf fix compilation for older llvm Nov 19, 2016
debian remove all audio plugins, we now use SDL2_mixer for all platforms Oct 15, 2016
docs/man implement partial support for avmplus Jul 11, 2015
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 small performance improvements Dec 4, 2016
tests implement partial support for avmplus Jul 11, 2015
tools [pygil] fix parsing Oct 29, 2016
.gitignore update .gitignore Jun 9, 2012
CMakeLists.txt Merge branch 'master' of github.com:lightspark/lightspark Dec 4, 2016
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 remove all audio plugins, we now use SDL2_mixer for all platforms Oct 15, 2016
Doxyfile Move all source code into a new src folder May 9, 2011
README remove all audio plugins, we now use SDL2_mixer for all platforms Oct 15, 2016
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 Firefox plugin is enabled (on by default), you will also need the
development package for gtk2.

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://bugs.launchpad.net/lightspark. See
https://github.com/lightspark/lightspark/wiki/Reporting-Bugs for help
on reporting bugs.