1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
[](https://frei0r.dyne.org)
<img src="https://files.dyne.org/software_by_dyne.png" width="300">
[](https://github.com/dyne/frei0r/actions/workflows/test.yml)
[](https://github.com/dyne/frei0r/actions/workflows/release.yml)
# What frei0r is
The frei0r project is a collection of free and open source video effects plugins that can be used with a variety of video editing and processing software.
[For an extensive introduction to frei0r please read this story.](https://jaromil.medium.com/frei0r-the-free-and-open-source-video-effect-preservation-project-604134dde8b3?source=friends_link&sk=c83a054b979d421279f5fc3d2ea1acd8)
The frei0r project welcomes contributions by people who are passionate about video effects, its collection consists of more than 100 plugins made to work on any target platform (GNU/Linux, Apple/OSX and MS/Win) without the need for special video hardware. These plugins can be used to add a wide range of effects to video, such as color correction, blurring, and distortion.
The frei0r project is a great resource for anyone interested in algorithms for video transformation and effects, as it provides a wide range of open source formulas available for free and can be easily integrated into a variety of software.
## What frei0r is not
Frei0r itself is just a C/C++ header and a collection of small programs using it to accept an input frame, change it in any possible way and return an output frame.
It is not meant as a generic API for all kinds of video applications, as it doesn't provides things like an extensive parameter mechanism or event handling.
Eventually the frei0r API can be wrapped by higher level APIs expanding its functionalities, for instance GStreamer, MLT, FFmpeg and Pure Data do.
## Links
Wikipedia page about frei0r: https://en.wikipedia.org/wiki/Frei0r
Some applications using frei0r, sorted in order of most recent activity
- [MLT](https://www.mltframework.org/)
- [LiquidSoap](https://www.liquidsoap.info/)
- [KDEnLive](https://www.kdenlive.org/)
- [Shotcut](https://www.shotcut.org/)
- [FFMpeg](https://ffmpeg.org)
- [PureData](https://puredata.info/)
- [Open Movie Editor](http://www.openmovieeditor.org/)
- [Gephex](https://gephex.org/)
- [LiVES](http://lives.sf.net)
- [FreeJ](https://freej.dyne.org)
- [VeeJay](http://veejayhq.net)
- [Flowblade](https://jliljebl.github.io/flowblade/)
# Downloads
Stable frei0r releases are built automatically and made available on
## https://github.com/dyne/frei0r/releases
Frei0r sourcecode is released under the terms of the GNU General Public License and, eventually other compatible Free Software licenses.
## Packaging
[](https://repology.org/project/frei0r/versions)
## Build dependencies
Frei0r can be built on GNU/Linux, M$/Windows and Apple/OSX platforms, possibly in even more environments like embedded devices.
For details see the [BUILD](/BUILD.md) file.
### MS / Windows
We distribute official builds of frei0r plugins as .dll for the Win64 platform from the releases page.
### BSD
Ports of frei0r are included in all major BSD distros:
- FreeBSD https://www.freshports.org/graphics/frei0r
- OpenBSD
- NetBSD https://pkgsrc.se/multimedia/frei0r
### GNU / Linux
Binary packages are maintained on various distributions, but they may not be completely up to date with the latest release.
- [frei0r*](https://repology.org/project/frei0r/versions)
- [frei0r-plugins*](https://repology.org/project/frei0r-plugins/versions)
- [ocaml:frei0r*](https://repology.org/project/ocaml:frei0r/versions)
### Apple / OSX
A [frei0r Brew formula](https://formulae.brew.sh/formula/frei0r) is available.
Official builds of frei0r plugins as .dlsym for the Apple/OSX platform will be soon included in the releases page.
# Documentation
If you are new to frei0r (but not to programming) the best thing is probably to have a look at the [frei0r header](/include/frei0r.h), which is quite simple and well documented. The [doxyfied documentation](https://frei0r.dyne.org/codedoc/html) is also available for browsing online.
## C++ Filter example
You could find a tutorial filter [here](https://github.com/dyne/frei0r/tree/master/src/filter/tutorial) in the source code.
A simple skeleton for a frei0r video filter looks like this:
```c++
#include <frei0r.hpp>
typedef struct {
int16_t w, h;
uint8_t bpp;
uint32_t size;
} ScreenGeometry;
class MyExample: public frei0r::filter {
public:
MyExample(int wdt, int hgt);
~MyExample();
virtual void update();
private:
ScreenGeometry geo;
void _init(int wdt, int hgt);
}
MyExample::MyExample() { /* constructor */ }
MyExample::~MyExample() { /* destructor */ }
void MyExample::_init(int wdt, int hgt) {
geo.w = wdt;
geo.h = hgt;
geo.bpp = 32; // this filter works only in RGBA 32bit
geo.size = geo.w*geo.h*(geo.bpp/8); // calculate the size in bytes
}
void MyExample::update() {
// we get video input via buffer pointer (void*)in
uint32_t *src = (uint32_t*)in;
// and we give video output via buffer pointer (void*)out
uint32_t *dst = (uint32_t*)out;
// this example here does just a copy of input to output
memcpy(dst, src, geo.size);
}
frei0r::construct<MyExample>
plugin("MyExample", "short and simple description for my example",
"Who did it", 1, 0);
```
## Join us
To contribute your plugin please open a [pull request](https://github.com/dyne/frei0r/pulls).
For bug reporting please use our [issue tracker](https://github.com/dyne/frei0r/issues).
You can get in touch with some developers over various dyne.org chat channels, for instance
### https://t.me/frei0r
We also have an (old) mailing list open to [subscription](https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/frei0r) and we provide [public archives](https://lists.dyne.org/lurker/list/frei0r.en.html) of discussions, searchable and indexed online.
## Acknowledgments
Frei0r is the result of a collective effort in coordination with several software developers meeting to find a common standard for video effect plugins to be used among their applications.
For a full list of contributors and the project history, see the file [AUTHORS](/AUTHORS), the [ChangeLog](/ChangeLog) and the project web page: https://frei0r.dyne.org
|
