{"id":19909107,"url":"https://github.com/dyne/freej","last_synced_at":"2025-05-03T02:31:37.243Z","repository":{"id":10274324,"uuid":"12388536","full_name":"dyne/FreeJ","owner":"dyne","description":"Free Vision Mixer","archived":false,"fork":false,"pushed_at":"2023-10-08T12:44:33.000Z","size":26867,"stargazers_count":41,"open_issues_count":5,"forks_count":8,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-07T10:35:46.160Z","etag":null,"topics":["party","veejay","video"],"latest_commit_sha":null,"homepage":"https://dyne.org/software/freej","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jaromil/FreeJ","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dyne.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["dyne"],"patreon":"dyneorg","open_collective":"dyneorg"}},"created_at":"2013-08-26T20:07:19.000Z","updated_at":"2024-12-11T18:57:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"8a90d447-5f85-46f5-81f9-f97689a6dae9","html_url":"https://github.com/dyne/FreeJ","commit_stats":{"total_commits":2046,"total_committers":33,"mean_commits":62.0,"dds":0.8274682306940371,"last_synced_commit":"2afb631cb3a429fdf312627ef904ec32b51e812d"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dyne%2FFreeJ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dyne%2FFreeJ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dyne%2FFreeJ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dyne%2FFreeJ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dyne","download_url":"https://codeload.github.com/dyne/FreeJ/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252133723,"owners_count":21699586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["party","veejay","video"],"created_at":"2024-11-12T21:14:23.048Z","updated_at":"2025-05-03T02:31:34.432Z","avatar_url":"https://github.com/dyne.png","language":"C","funding_links":["https://github.com/sponsors/dyne","https://patreon.com/dyneorg","https://opencollective.com/dyneorg"],"categories":[],"sub_categories":[],"readme":"\n -=:[ dyne.org software foundry ]:=--- -  -- -   proudly presents:\n\n\n  o__ __o__/_                                            __o__\n \u003c|    v                                                   |\n \u003c \u003e                                                      / \\\n  |         \\o__ __o     o__  __o     o__  __o            \\o/\n  o__/_      |     |\u003e   /v      |\u003e   /v      |\u003e            |\n  |         / \\   \u003c \u003e  /\u003e      //   /\u003e      //            \u003c \u003e\n \u003co\u003e        \\o/        \\o    o/     \\o    o/      \\        |\n  |          |          v\\  /v __o   v\\  /v __o    o       o\n / \\        / \\          \u003c\\/\u003e __/\u003e    \u003c\\/\u003e __/\u003e    \u003c\\__ __/\u003e\n\n              [[[  FreeJ 0.11 \"alive in babylon\"  ]]]\n\n                      http://freej.dyne.org\n\n\n:: OVERVIEW\n\nFreeJ  is a  vision mixer:  a  digital instrument  for realtime  video\nmanipulation used  in the fields  of dance teather,  veejaying, online\nstreaming, medical visualisation and TV.\n\nIt runs a  video engine in which multiple layers  can be filtered thru\neffect  chains  and then  mixed  together  with  images, movies,  live\ncameras, particle generators, text scrollers and vector graphics.  All\nthe resulting video mix can be shown on a screen, encoded into a movie\nand streamed live to the internet.\n\nFreeJ can be controlled locally or remotely, also from multiple places\nat the same time, using its ascii console interface; operations can be\nscripted in  javascript and triggered  live via keyboard,  mouse, MIDI\ncontrollers,  Joysticks,  OSC  clients,  Wiimotes and more devices.\n\n FreeJ's sourcecode is  written in portable C and C++  and it works on\nmost platforms  supported by the  GNU C compiler, including  32bit and\n64bit processors, PowerPC and various ARM flavours.\n\nFreeJ is released free under the GNU General Public License (v3).\n\n\n\n:: FEATURES\n\n++ reads and renders layers from multiple sources:\n   webcams, TV, divx/avi movies, images, txt files and more\n++ can encode in Ogg/Theora video, recording on local file\n   and streaming live to an online Icecast server\n++ can be controlled from remote: VJoE - VeeJay over Ethernet\n++ can be scripted in object oriented javascript\n++ supports frei0r and freeframe video plugins\n++ very efficient video engine with multithreaded layers\n++ Emacs/Vi style console with hotkeys and completion\n++ multiple controllers at the same time (Midi,Joystick etc.)\n++ 100% Free and open source, GCC 4 compliant portable code \n\n\n\n\n:: HISTORY\n\nThis software started being  developed as a digital instrument Jaromil\nused  in dance-theater  performances. Since  2001  ongoing development\ntook  inspiration  from   various  artists  and  programmers:  Andreas\nSchiffler,  Roberto Paci Dalo',  Tom Demeyer,  Francescopaolo Isidoro,\nKentaro Fukuchi,  Luigi Pagliarini, Isabella  Bordoni, to name  just a\nfew.\n\nSet the VeeJay Free! was the first motto for this software.\n\nIn 2003 Kysucix joined  development contributing the streaming feature\nand helping  to include  the javascript parser.  He employed  FreeJ in\ninteractive installations while working with Studio Azzurro.\n\nSince 2004 Jaromil has been employed by Montevideo / Time Based Arts\n(NIMK) and his research  and development  activity also converged in\nFreeJ development.\n\nIn 2005 Mr.Goil  joined development, writing programmable controllers,\nreviewing the scripting environment and adding more features.\n\nIn 2007  the austrian initiative Netculture.lab  supported Jaromil and\nMr.Goil  developing the  BeTV release:  it enhanced  scriptability and\nstreaming, with a major cleanup of the code and wider support of video\nplugins.\n\nAfter revamping their enthusiasm in the Chaos Computer Camp, in 2008\nboth Jaromil and  Mr.Goil met  regularly in  code sessions , rapidly\ndriving the  project  towards a  stable  javascript  API.  Meanwhile\nBlender2Crystal  developer  Caedes  has  joined implementing  python\nbindings and using the FreeJ engine in a 3d environment.\n\nIn  2009 FreeJ  development  is  sponsored  by  Digitale Pioneers  and\nalmost  the  entire  team had  the opportunity to  join the Wintercamp\norganised by  the  Institute of Network Cultures in Amsterdam; here, a\nweek  of  coding  \u0026  sharing  gave  a  significant push  to the entire\nproject, leading  to  many  bug  fixes  and  some  really  interesting\nrewriting and optimization into the code. Those magical  days  saw the\npresence of Jaromil, Acracia, Xant  \u0026 V@nex living  in Amsterdam, Vlax\nfrom Oaxaca (Mexico), Kobaiashi \u0026  Shammash from Italy, Crash, Tomak \u0026\nAsbesto  from  Sicilia  (Italy),  Mr.Goil  from  Germany,   Andy  from \nAustralia, Adnan from Switzerland, Lluis  from  France,  and Rama from \nArgentina. What a nice family! :)\n\nFor the time  being, FreeJ is employed in  various video performances,\ninteractive  installations and  online TV  streams, as  well  used for\nvisualisations in medical analysis.\n\nDevelopers are  keen to accept  projects and propositions in  order to\nsustain the  development activity and involve  more developers, please\njoin our  mailinglist on  http://lists.dyne.org to collaborate  and be\npart of our history :)\n\n\n\n\n\n:: GET STARTED\n\nTo start rolling with FreeJ you can have a look to the online\ndocumentation on http://freej.dyne.org\n\nMost  powerful uses of  FreeJ involve  scripting for  live interaction\nwith devices and video compositing,  still a first look at the console\ncontroller can give an initial picture of how the software works.\n\nA nice tutorial to start is: http://lab.dyne.org/FreejTutorial \n\nTutorials,  examples and  scripting reference  are available  from the\nwebsite as well along with the distributed sourcecode, in the doc/ and\nscripts/ directories. GNU/Linux distributions usually ship these files\ninside /usr/share/freej and /usr/doc/FreeJ*\n\nAs development  unrolls suggestions and feedback are  welcome, join us\non the freej mailinglist on http://lists.dyne.org and let us know your\nimpressions and ideas.\n\n\n\n:: REQUIREMENTS\n\nTo compile and run FreeJ it is necessary to have:\n\n- a working GNU/Linux system\n  or Darwin/OSX -\u003e see the documentation in README.OSX \n\n- SDL libraries http://www.libsdl.org\n- PNG libraries http://www.libpng.org\n- S-LANG libraries http://www.s-lang.org\n\nSeveral  other  libraries are  optional  and  strongly recommended  to\nbenefit  from  all  features   implemented  in  FreeJ,  in  particular\nOgg/Vorbis/Theora libraries available on http://www.xiph.org\n\n\n\n\n:: HOW TO INSTALL IT\n\n  ++ GNU/Linux users:\n\n     On  Debian  and  Ubuntu  'freej'  stable packages  are  ready  to\n     install. Release  candidates up  to date with  latest development\n     are also published on: http://launchpad.org/~jaromil/+archive\n\n     On Gentoo it is also possible to 'emerge freej'\n\n  ++ Apple/OSX users:\n\n     Binary packages  of FreeJ  for OSX should  be available  from the\n     website  http://freej.dyne.org,  although  they  might be  a  bit\n     outdated and limited in features.  It is also possible to compile\n     FreeJ  from  source following  the  README.OSX  and using  XCode,\n     MacPorts and Fink.\n\n     In case you are a programmer talented with OSX please consider to\n     get in touch with us  and contribute to make this software better\n     on the Apple platform, there isn't much work to do anyway.\n\n  ++ Windlows users:\n\n     No-one of us feels to compile FreeJ on the M$ platform, but there\n     is a quick and easy way to try this software using the dyne:bolic\n     liveCD  even  without installing  anything,  just  boot it,  see:\n     http://dynebolic.org\n\n  ++ Game console users:\n\n     Experimental builds  of FreeJ have succeeded to  work on consoles\n     as GP2X and NintendoDS. It  should be also possible to make FreeJ\n     run on other embedded devices and we are very interested in doing\n     so, please contact us if you are as well :)\n\n\n\n:: TEAM\n\n Denis \"Jaromil\" Roio        - FreeJ author and mantainer\n\n Silvano \"Kysucix\" Galliani  - Scriptability, encoding and layers\n\n Christoph \"Mr.Goil\" Rudorff - Scriptability and several controllers\n\n Luca \"Shammash\" Bigliardi   - Debian packaging and core development\n\n Andrea \"Xant\" Guzzo         - OSX porting and core development\n\n parts of  included code are  written by Andreas  Schiffler (sdl_gfx),\n Jan  Gerber  (theorautils),  Dave  Griffiths  (audio  bus),  Nemosoft\n (ccvt), Charles  Yates (yuv2rgb), Steve Harris  (liblo), Sam Lantinga\n (sdl_*),  Jean-Christophe  Hoelt (goom),  L.   Donnie Smith  (cwiid),\n Olivier Debon (flash).\n \n\n documentation, testing and user case studies have bee contributed by:\n Anne-Marie Skriver, Marloes de Valk, Piotr Sobolewski\n\n refer to the AUTHORS file for a full list of contributions\n\n\n\n\n\n:: DISCUSSION\n\nA mailinglist for further discussion about FreeJ is running on\n\n                  http://lists.dyne.org\n\nFor chat we hang around the  channel #dyne on irc.dyne.org - access is\nfree via  SSL on port 9999,  connection IP is kept  anonymous for your\nown privacy.\n\n\n\n\n\n\n:: DEVELOPMENT\n\nTo follow development activity,  visit our new distributed versioning\nsystem on http://git.dyne.org\n\nTo test new branches and latest code, use git:\n\n # git clone git://dyne.org/freej.git\n\nthen generate  the build environment running ./autogen.sh  - note that\nautomake and aclocal at exactly 1.9 version are required for it.\n\nMore detailed instructions about installation by git can be found\ninto the INSTALL readme file.\n\nPlease download  and run  the latest  code from there  if you  want to\nsubmit a bugreport, submit a patch or propose and test new features on\nour mailinglist.\n\n\n:: DISCLAIMER\n\nFreeJ is (c) 2001 - 2009 by Denis Roio\n         (c) 2004 - 2005 by Silvano Galliani\n\t (c) 2005 - 2008 by Christoph Rudorff\n\t (c) 2008 - 2009 by Luca Bigliardi\n\t (c) 2008 - 2009 by Pablo Martin\n\nStatically included libraries are copyright of the respective authors.\n\nThis  source code  is free  software; you  can redistribute  it and/or\nmodify it  under the terms of  the GNU Public License  as published by\nthe Free Software Foundation; either  version 3 of the License, or (at\nyour option) any later version.\n\nThis source  code is distributed in  the hope that it  will be useful,\nbut  WITHOUT  ANY  WARRANTY;  without  even the  implied  warranty  of\nMERCHANTABILITY or FITNESS FOR  A PARTICULAR PURPOSE.  Please refer to\nthe GNU Public License for more details.\n\nYou should have  received a copy of the GNU  Public License along with\nthis source  code; if not,  write to: Free Software  Foundation, Inc.,\n675 Mass Ave, Cambridge, MA 02139, USA.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdyne%2Ffreej","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdyne%2Ffreej","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdyne%2Ffreej/lists"}