Skip to content
This repository

An open source flash player implementation

Octocat-spinner-32 conf fix compilation with ffmpeg 2.0 August 16, 2013
Octocat-spinner-32 debian Bump version March 16, 2013
Octocat-spinner-32 docs More documentation about command line options November 09, 2013
Octocat-spinner-32 etc Document only working audio backends June 14, 2011
Octocat-spinner-32 i18n Introduce multitexturing for masking October 18, 2010
Octocat-spinner-32 media [media] Remove 20x20 icon, seems to be not needed May 17, 2012
Octocat-spinner-32 resources Use error messages and IDs from Tamarin February 26, 2013
Octocat-spinner-32 src Update swf.cpp March 27, 2014
Octocat-spinner-32 tests Count Tamarin tests which passed all test cases September 13, 2013
Octocat-spinner-32 tools [tests] make-tamarin now compiles tests from recent Tamarin May 18, 2013
Octocat-spinner-32 .gitignore update .gitignore June 09, 2012
Octocat-spinner-32 CMakeLists.txt * fix building with llvm 3.4 February 14, 2014
Octocat-spinner-32 CONTRIBUTING Add initial CONTRIBUTING file September 19, 2011
Octocat-spinner-32 CONTRIBUTORS Add CONTRIBUTORS file January 24, 2012
Octocat-spinner-32 COPYING Added license block to files and GPL-3 license to the repository April 02, 2009
Octocat-spinner-32 COPYING.LESSER Relicense in LGPL3 June 05, 2010
Octocat-spinner-32 ChangeLog Implement JSON parsing October 26, 2013
Octocat-spinner-32 Doxyfile Move all source code into a new src folder May 09, 2011
Octocat-spinner-32 README Update README November 09, 2013
Octocat-spinner-32 README.GRAPHICS Rework graphics architecture a bit May 11, 2012
Octocat-spinner-32 README.tests Improve naive reference counting performance September 19, 2012
Octocat-spinner-32 README.win32 Readme.win32: update instructions to build librtmp June 14, 2012
Octocat-spinner-32 RELEASING Mention testing in release guidelines January 28, 2012
Octocat-spinner-32 TESTING Add TESTING file for contributors September 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, 3.0, 3.1 or 3.2), opengl, curl, zlib, libavcodec,
libglew, pcre, librtmp, cairo, libboost-filesystem, libxml++ (version
2.33.1 or newer), gtk-2, libjpeg, libavformat, pango, liblzma

If sound is enabled (on by default), you will also need the
development package for pulseaudio-libs and/or libsdl.

If the browser plugin is enabled (on by default), you will need the
development package for xulrunner.

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

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

Sound support may be disabled using the following option:
-DENABLE_SOUND=0 The audio backend can be set using
-DAUDIO_BACKEND=<pulseaudio|sdl> (default is pulseaudio)

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.
Something went wrong with that request. Please try again.