Skip to content
An open source flash player implementation
C++ C ActionScript CMake Shell Assembly Other
Failed to load latest commit information.
conf Make it compile with LLVM 3.7. Sep 27, 2015
debian Update dependencies in debian/control Mar 28, 2015
docs/man implement partial support for avmplus Jul 11, 2015
etc/xdg Document only working audio backends Jun 14, 2011
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 optimize Number class by handling whole numbers internally as integers Apr 24, 2016
tests implement partial support for avmplus Jul 11, 2015
tools detect cloneimpl() methods Aug 23, 2015
.gitignore update .gitignore Jun 9, 2012
CMakeLists.txt "s:avcodec_get_frame_defaults:av_frame_unref" src/backends/decoder.cpp Sep 30, 2015
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 5, 2010
ChangeLog [TextField] implement rendering of embedded fonts Jan 11, 2016
Doxyfile Move all source code into a new src folder May 9, 2011
README [SDLPlugin] switch to using sdl_mixer to enable multiple audio streams Jan 4, 2016
README.GRAPHICS Rework graphics architecture a bit May 11, 2012
README.tests Improve naive reference counting performance Sep 19, 2012
README.win32 Readme.win32: update instructions to build librtmp Jun 14, 2012
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, 
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 sdl_mixer.

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

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.