From 5333760daa8e982682ae4e00fb5e0711c3675c1d Mon Sep 17 00:00:00 2001
From: Stephane Letz <letz@grame.fr>
Date: Sat, 27 Apr 2024 12:32:09 +0200
Subject: [PATCH] Add Faust in Cables.jl project.

---
 .../powered-by-faust/img/faust-cables.jpg      | Bin 0 -> 162688 bytes
 docs/community/powered-by-faust/index.html     |   8 ++++++++
 docs/index.html                                |   2 +-
 docs/search/search_index.json                  |   2 +-
 docs/sitemap.xml.gz                            | Bin 127 -> 127 bytes
 mkdocs/docs/community/powered-by-faust.md      |   5 +++++
 .../powered-by-faust/img/faust-cables.jpg      | Bin 0 -> 162688 bytes
 7 files changed, 15 insertions(+), 2 deletions(-)
 create mode 100644 docs/community/powered-by-faust/img/faust-cables.jpg
 create mode 100644 mkdocs/docs/community/powered-by-faust/img/faust-cables.jpg

diff --git a/docs/community/powered-by-faust/img/faust-cables.jpg b/docs/community/powered-by-faust/img/faust-cables.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c71f04032f5c81d26ae2b95303f065464510c18e
GIT binary patch
literal 162688
zcmeEu2S5}}vhZvmXIPY|NL+HxAjt(5BrG|pWR{$fpt7JCRzR|fgq0ixm8>YJh=Amv
zL{TJ4Py`bq|16+>-*@-kyL<oLy$cS^PEAjBbyszDcXfAlZ$00d1nBj&(b@n60ssl%
zAF%Zj$U=p>y8?iL0U!hb069PcVFX|x1Ofj52pd4M4FiB4g#8C>0zvNLKmp*KI{@Fs
zu>qgN3#3epz59eEodw9iH%9P2Lx6tArcx)szQbhX;5R_SR11v;pQcU$E-pTSSl^(n
zmlOxEK|y{>;^IDmVh+x}jxJ(OzTV=Y4u0a2ViMwjidv|jgOjIA5SOEio4b!H_sX67
z++6O?s@#^c1`-B-S}s_3-S7Yx({MvGr*KavMQ3icgIp@1N}=9<-Y!87T%q1xK7mT1
zs@&Vel|YynEY8ifjS}Rk%57y}%%$ZU;KC&*CLt!l4aN>|c2zPtq`ey#d{gD#&E)ap
z$Hk6Ii}?n)iAyRfDvC=;iAza|f*7KKVLm|)p`t#4Jl`oCatU+_aQ6#x_x0f-Qgm?i
z4GvP}<`xH25Z_IL2>!_HL9SodFA4mTz%L2>lE5zs{F1<bo&<hcJ1#z;iE|vZWq_?E
zK*1O^m3%>a$&X7~Oaf5QL>s_~CK-5b!+hHy{Qzg|@Fn0Dd>%(}W$}~dsjXM^<Y+Ce
zW5y;%+UUcmZL5&(lY^h17nB|VynTWKOmsB4tgLOg$Yud3KnKtQ`vD3Er$9dqW8=d_
zn%|$>^nd((7}_@efPPUTtslXE8Nlcannj@XXa}M@ItMy=gK!f7z%!iu0)ha5lo-x)
zJjjm-<3Jb@0A>(`Q;4wJ4qQZp9e3cn+c;(>S|CmjXx~yhI0U!>0PPqU&K2V12GXJZ
z3c?aT&h9<{Kqmsi2c57E&LB+8yNI{9FA=^1!blL`4}_aQSi$i(G~Ip!J2*K0pzq+|
z_5<GG3ycY7;*fiwpO-_}_RHV$$J;9yl->5l5B^eP19VNmCjyk=b5CD=B1{d!i$0Eq
zMj#9t<d9G9Aa^@3loA`PYYxI7K9s{LP>X2J?*U;6XNN=jAj|>6+CE-}hj+srUEQ^b
z_ByC7&`|dvv>6Dqfbe;jK$Ph&4k5tTWH&8njcb6G#%}l%hX4@TNoyk5)0`Miq`!)F
zLGRLs(S~EqEWvO}0D$p^xLX*4Ff9m+1$vqi^8@A$rV@_TB8G3{1O%H9^Un*0o4EMs
zXo4`v3oOJnK%2-r5g+dz2twPu!w6V+G%+qH2iUD3teGwdgYtnra&p+tKgbKL$Hhlu
zS0=C!mq06G-ave4jkC)k6bOU7!{%Ik%!&LG>3s4F(j=w@#)VV*d2QDdFdWY9;-y0j
z=LTV!z!1~jxNwW005f7Zm`}K?Uyw0ThG0J7;T{fp#vlyl2c7^N2DE@f02dGp-j0AT
z-~qUIE!HlAZ#!SK0S6!ea06Tb(cO^mF)X*g_<+BrKsc}j_<%TpKjLX_e{}&u!0^o<
zp*wL!0oU!XA=@!Lff+CbZ$KaL0^fr{*aeL9Jv9s9H5lUl<NbT;4j@e@Fuz{lP5l1n
z!@r0A#MA)!J-iz?_<M?6bl>BXqDT*s>XK@c3c}go2jR-_!{DzvcuT<*;ELb*_=!(4
zL()s~ie!*vl4SUpdvw4bWMlwLf*kG0&;^w5Z)5@I2WiT}HQ}ltb&xWA51b7Uh0B2H
zXu#FLlx4wCtz8a@Qu$sYzvbx%2f)wL*u|repny{BrBJ6p{xK%45UuQYez#@)TS@NZ
z)$xbCzvtjj)BpL!9dHKossE!ic5?tb54#O(g*C(4V0U4)02k~&tPb`R)<}eR)7RcE
zUAG^pnQZ6B6D$|^A2{FnC6+ibO`?7TN|Z{>OMKm-666vZ1nM)O<?9y~;O>SE;?e+n
z2Ny21kCT`Pmz0E*Gyo9$8X^t=yvJ<!A&@;!e}<iY0RXD^x3;$K{0!5(4*)mi!RlZC
zGYqK!01Q+B@TA@;I3Q$)9-R0f0b2<=u%@vB`v4vQ3GyQa$N|cLI)DQ703*N*um+BT
z`icehJODTjoB*PLv%p1g8Y2}*2eN@&pa>`jZUMExU7#6w40HfJz#uRRYR@$A26zj6
z05%{H2pNP1!USQ3?1%6{gdtK81;{}N3UU}?0<nhJL);)fkYLCO$Z5z$ND?F+avf3(
zxe2L<G(*}Ty^vwZOUOKA74iiNgHl5gP);a6R2-@R)qv_l&7eo1Zcu+{IP?rO9(o0u
z11*ErK%1c*&_U=V^bK?!2EeFbdte7(qA&%R7R(4{19OE1z)r#Nuryc>>;|j>Ea!gM
zBy17(8BPjkf^)$|K@HZ0o5P*p{_s=qSa>?T2wnq!1n-BxgujJ<BcUPTAQ2`}B0-Z_
zk+_i@Cpk-!Mp8ghP0|9^rD>86q@<*KNCimc!MbQo>OmSo8cUi<T0z=G+Dke`x=uz$
z#!4nkrb=c+=0Fxic9!faSsB@VvOcnDvQOkx<on5`$hFCB$bHD8$<xS7$nTN&k<XHE
zP|#EGQ7BOuQ8-hCQCy<PqiCS$rkJMKpk$yFpj4$aqx7JRqP#+RgR+HkjPgAd6%{v?
zA{B<poeD>Fg{qS33Drxg&(w_6LeyH+cGSVt@zjOXP1M8G?`ddg_-WK>Y-oaL;%SO$
z9@0$Ee4=Hd6{AJdI@3ndUZbs{?W0|$qoCuX)1W&_7fzQ(cbl%8ZjqjXo}XTe-huuU
z{Wbb}`e*d(3``7?3`Pvz46zI)3~dZ^jAV@bj3`ED#xsn$j1L*7m|#piOj=A%OsARh
zm|B>o5u^wK1RCLixQHl6bRpg{GcwCCTQG+*Ut?}$p4<c5!@mc;$7|1}J-7A@?fJ5o
zbFao;m%SJE-q_o>_ah5Ci#m%73!bHdWsv0yD;Fz@)sr=mwU%|94bCRShG9F-mc`b>
zw#bfPS7vu&$FtvJAK`#<2yvKjL~!JCJmpyD+{dZI>Bo7M^C9QrzCHWY_j&9~*>`W>
z{C=kW2lu=0PuYKe{{j~?mj;&?*A=cuTyGC>9MC-weBk<lt^*s~0^H`@(cBf><2;l+
z3OuenDLfB&-tz9}HQ+tLTgp4aN5QAShvmD>*UI;iUx43|{~UiU|C|7e09qhipj2QC
zNrO~F`Xh6Y1A?T23WA=3nSwn+P$5|%tk5-~ZeggfoUprarf{zaiHM?zk4TQlGf`?$
z4bc$MQqh-Ud&CZlMT^ynEsOJt+lVKMw~Bw0kd^R~$deeAWR%pCjFxPWT$K`%a+10x
zH6TqRtt}lXT_^ocMp(v0CQIhIER(E(>^a#7vYT@9ashHT<mTmh<?ZD&<ew=Z6pR&O
z6`m-PC~7K3D&AH6tR$xtq;yMZMOjqYQ@KQWPDMb)MI}#VN|jsHLG`-o<Uy{3_6G?E
zC)Ez9IjH5Ry;A2<cUCV@pVbi5@X#pJSk{!#4A89B{HUd*byBP85bTi7A^f2(6eG$U
zm5!Rw=GJ!8F4cakBdZgk)1*tHtFN1=`wY#Ac0w1U-|EThoz#1zPpxmNpRWJvu+ZUv
z!wm*d13iOegE2!sLm$IhBfto4lx#F^EMV+!d<R2{F~(fO%$P`;oG@uMWimZxT4MUa
zOw;U=*{C_vJlOn!1)YVRMX|+4%R`n)mXlWERwu1Gtl6yHt?O*aY%FXFY}Rd2wyCz$
zcCvP7?S_sB90@(rc9iX?*U`pfbjKWy-L@yOx3n*@|LS1mkmIoKh<40yeCwp;blK^R
zv$}JN^Sq0yOOng1tEy{~>ztdaTe90cRt=kmU3AxSPj`Rkq3e<D@zK-Bv(R(P%hIdD
zo7~&pyWWS<$J6JL?>^s9-(Ejqzq5Xm{!0F-{%-^H0}28mfky)Cf)Jol|1=mG925L9
z<Y36PkWa@gj^7St2=xhl8YUEWA#65WJ3K!E9^n-6;KYFwQ72xW)Hr$l6y%iSsRxlf
zk!K>OaXPr7D9R|$sLp7K=%nbi)0U?j&TyW=otcW!i77oxdp6+gvvbPlvd_cMyPxm6
zAbsKLg>QIgeEUU-i)k0X#yZ8e$4SOriQ9^Ijqkc7cPT4@G{GlfC{Zo3D2X8{JZUP~
zAh{-mD+QmjmU=9;ElnmZ`!eO_;LDR&4qvIe%6m28>eqB^`rtLqYZVzB85c4>W;$o~
zWvOS~$mYzxnEi#|PI!J@=Xy;Je@<F1X>LgFOrAwvYraB$aRFPw#e&U3pTfx^lcGn(
z^2Nm^93_`Zp{2p4^JR8rJ>`eW>u!kNxL&cR;$kIG8C<z=)BfhrE&W>$ZY$irQN>r4
zQO#71uYuHr)x536)=t)0*Y(!x)jw!ZZm7N^cBk;}fxFilnHw+Nqr7+K-q!u_`|C}9
zO^eNL%~KDKJs5px^>E-3=22IRe#?``+K(T$YP8;eqWa`+n^IeSyFz<yhg?U^Q`x80
zowA+PU2<JD-SXXaJ&HXIy(+!;`qcWG`w#U$9zYLt3>psh4w(-<e`fb=^11W#xnZy2
zcOxMq8>6@}k}>=^{dn30$3)Hx!50;ia+8fO550W)%JkLfl+)Ck*MYCUPM?{fnMs@7
zKU+K}HFtMjd%kDEc47LB-<yravr7z18OzA!sulH>r*Ey^PQMFyx3wDkp7nj<n#|gR
zb>sDk58fX(KH@*Iek%H`@VWJi<(Juw<6p_XUfC4fZ1|@CZEVYXYs=3ez+u}KATDk|
zUBM-f)j|NEu?7I99?*WU-5CpRV{9*d>_XrWX&c&k{s!I|FK&O61ArT#{f=1#t(#{6
zP?-k+{2+ZgI{+}I0RS^a04gp0<K86~=qfF>lLj?7P9d4t+IkO;*~pRsU^8KBYa?fC
zYcm%dPmBRTlh4i=l!#3VjyDMCO-FCXT{6FW?2J#rpzl2X@d<J+EiFTg^SkF(6Tm=D
zMoy&;gKz^-1_+D+vh@fY>;n)I(4YaY@2NnbFgOV*894<d6^Kwx4?rO>7!(d8At6pU
zKu&_+0XPE*;{izxQYMT88Mi+|Dk||hIgjSeW@eM#x4hDh0nrqcd-k%hvhnc?AO(eF
zWaZ=)6qU3Np|o{$(R!w4<`$NqDd*(u;_8NV_XrFM4mlng7Jm9n%-M72FW{4sQ&Q6|
zU%8r|lbe@cP*_x4a_e?gbxmzueZzx?k6IqLK51+3>mL{#diH#H<mIcW*V8kzbMp)D
zR^P9!fB5+6^A{pt5CFEr)(_79z!w9^7ZeVM!O4hxL7>OM8^!=9IUq^OsDUAK@Mq$d
ziXum7CSJeUOu-{<@|M{#pqFwFugpuncSP2<Is3~Pi~e76_JgsXe2s!;H^=rR!NDPM
zNJ2v5kli8hvJ0{!UO}-z+gI%FRkVFQB3@%Zt}T!VgqxRFK}Nw|M#g?71D7%LS6^G>
z;HqBL)(AiigMi8eV*u2EnYkPsg#rS=*ihvkyS2=~5s^SQou1F@%aoF+SGkCVq+n10
z;&-=R$x}Z<@{&3Q3eK!-Wq--0@BYpBP9EokgImD+bf7Z_j|6t^EGqY9G`*l#Fo7Id
zsHEcK<bT#QTCfVhpuhwzMZ88nm@-z{i7lp|%uF9UB765ztxwo`Yd&C{lb<C?-OX4t
znHT$Iz-$NK)-t5W+KM*-Dg7icYwFoop^PC>n)D-Sa7EaDyDcCF!2C@3dj=W{u0>Xt
zj1{@~kcLCUjY-&q#@CCh>all%O&2}#0fbrNLz&^##B5GKX#=z4-skhL^-!k+-pndB
zwGubxom}?i`5PNUP#)D8g83H<yRR%ob>II)*%>d$=Y3PqX^s>Wk7<oUq)732h7-q3
zL4<Nqf5fBale#jHqj)3%`s@BBgTJE=&~5e1yg9BF#imoAoac0@c*V-RckaGw`6H)_
zPp8#cZ!cU9c<PL%q<%|w*gWFm)fHzN!LjE}&}_F5QPzvvw|o}IOHZvLFJr1kt_Pqe
zoeK4U+|5*P%905~Mx8k_kKADU54FOujB`9Riw0gE5>{<NHm?HWaB@=$%p~hARgVX`
zPENBx!#)t;C)rrogCD(gnu5PYmng-Ydwx}~X6@A3@;8q*i}$L)yVRIW7GAuY@?6{h
z#F)g^TbAv`l4U>`CM&BTx3NFwu6`iwbE15t-pD=t;F7)mg~J}eW75DD(<D!ps$o&?
zYfl9d6He+>0~S?%r=EEUST>8sI#m|dWZLsR7sCP0S#&Qg4uo9N3^_`x`?X70&8UB9
z>8SfPXY@e)y($QH-s1hCK5K&+sbJE}hwwb&>CTT%a|sl++Vu3r;F2_4?J}s-=B>WS
ze~ql@>47dJ*tYU?a9q#Km{t{Z>6^ma2D#G;bSun-w!Sa1+ydTh$ZyPk9=dm{#i`n5
z5~sU~gmHfv7#?E@th1*-8E85_zXiCQ6&Ta+_^R-s+;$H2X2dY}f&^WE#ixFse8x8t
zEhAE7Q$sjm5Y1Mzq&E3X;upxs?Fz4n_G6;)liC{V%(X?$PJF$d7uw~3(b!3IRf|_6
z*z3Cc!wyG>tsx*6j_{{<xD-~8Ub;7VinaCAGdYL=v|*$1V3^m-YFrUT+^}lX7h_WG
zTDr@}XK0gvNQM>-e@Cuc_{D>VuS{`DN!xs>zOx0mJzBNDYX!e_itY`*B617hitsJj
z0(jIBjF059p56Iu8dvwRh3!<<v$ChQj^d`4ueN{$>g;0+f<yQDFGvfR7)EM*ErL#5
zbMvNNlC656QR~jx%JWs2mI@Pg;%(Y!2gmxH$I$65V88DcVAuT~(Qxc*%&~7IU*}+|
zUK9F{Z=Zi%%8)##JXH7rbv=^H?$pQrOVbuIJ!)0Umrm4vi?L$3vsr!Y)7_>>jvkm8
zSJH^<S;JCO_g;z$NA3BHZ+1gx?~;uqd=%U?FzeH0J7fKE|8)Y{8>y?}S0lJ6)w0*i
z1HEdM%qW+6%pXecKfM24nW`~EB=R8Pn`2c4`diECv5Hl&k)G9$6TLU+E^y^^xkY9F
z#QK%x=NAV{_0cmArfruew*WD0t+I@wUNG<MJFZ9};QYLV0lRF<1MQ<Z#q%Hbd%J0l
zQc|xKuSubn$utXP^9yjY?3GGBYEOGetkxnz`1fRlH8~e8SsRb+y}KuXv(Vo}M^$Jj
zLEl5@(d*3NuW^RitDIXvRQ9ww>od6=s)ruzT=dfGE&7p89~6fW-qSc$$$?k-18T2D
zUaW|(GP~IZaxNM+nrrNjk^wk{hDgls)IDERqD@Ub?j!29+WT;g3qR%_v}B7-xsv~w
z>{B>fOXKYb!Mg>@QLJPG#-ueB7s^GKHxeLUwLMA2#h)INSC;NldR1FZcUiYaYhX$3
z)BKHaoU-V_<q2!Hi9xx?r@6kQ&n#8s-<Beep591&QqBq6JdwS;1=u_gpfzd)f=0}r
ze!M7jg!A20@&5ckmRVS~-h$T(lc~<_M3wuO6}94p8N0?ZQCuoZry?iSzLfwygHO&1
zM;Jb-SL^udu@p02m{F64j^Pn$z2R@waQB|~`!D>6Q~Ni=PhA8x=gqfy0z9Jj_JCWO
z1ck`M#1$Jh^QGy|Hgx=&5PH(zs`kZhWt_+?qG*5K0H>}aF;t=inj6gYukKN6;D}o5
z)UXhn+>q^PqSeegnCa2@2UF&crp>SS-<x{B<nh<aBXX;EX5mA2xL4tO^7hJyl({G%
zh;H8n>8p2#>@reWw*bo1m;s)wSAwFqH*TEySmuF*<)$AI#*E5zIr>THd}hAtHze%O
zTJ;3Q<FEQQ{L9cu1f;lh>|wCqE%nh9F4ks_*Ix$GW5$?9G&l^>)a9x7DU^jHVW))e
zD0iT$?>WY1vd^0>KRX=1Uu-ZPE&cJ%No5Nc1f;UokLEzR{;9WFR}K=^=MDQ-M5oT`
z>*rQGcdKDeTU8m88F&Wf&#z2Bn*O*s%Tu5fQdVkv-dmPVg3%EkyRmOQ69ssCP!%YI
zy-cZ!4<PeBH85_nOm$__%GO^!u$g84jn$el8M?qju5#r34O{9nOOsi2{R^JtV`?J?
zJsYF7r|OH41loA_pmH6re#Hw-&HG<lpyqE)<UHXd*e8#D8B{_-JFgw8#oV1GFXUaH
z@AkM^JT5xe8yas6K<2-Nl`SA)9__1RRvqpE&&M<GG7UsT47{_mI%36FK6>TpsjL@K
zOLprBNKbc!!)7*LemxHhCAp%?>GX<%qs<5-_uy~k8=IlBabR%_-JX|Y+%Klta!y1;
z;lrdwaLiNs7geh@^vknk^<^bUm<juI?SOOrv2=OY?m7Wk0&Q&Ves4yO*^se)_YYgj
zqX64`4f2;sz3hWvJ(SU`Hmnxr3wit7b8~R=!B@^?9a*!>!$D7Om~{jf>N_##Kg_^M
z<4&0<uazCE?*8C=%k5)Wrv-uL^NqzNk@UW{i?`Q(D~|OM`hBmTm9K8t0?Y*>53dso
zH5Y$U+Q2et{OK);CbBJHK&U1)f|^NRw14vc38v(1kCq&q`26h_-_To6LyEeLj^>VJ
zJi`<e`1H>heEuq|ga_u`uA!wj>*|kBE^<<EDw~VyEey>pD<Uq(B57hz4}2L?ML_P|
z#Kt^&BaGx&oc$_oJg&c4ej@P!ZSP~FLK9E6GF!V2cY$jZtdA90U*Tk`>j!6TL%%I*
z?Y~fFW8wJJIv)KxT@QHHCq}4F1*eoKC;f~fJ@8%nP~P}=MxDK_9-TQjC56I%nL&5a
zu?`+;>Mh_)i71P2UD~qIOB3`*l`TN8xtP)2(ZcF^kwY|OvInX=gJ#oSc$D3BV?MdX
zH-zuXk};iXWU5=QI@`@|M_<>7)E69QUe-?u+z?u$$+NmykJnDTxq4}pBrwGo{)|cX
zQKz(@)y(xAJb?Ul|B}JqQ3tmAz{!(eYWAy|{rl*^R{t-R{#B*_t$K~Eftk5tXc22<
zdu;2xIzz9CtN3!?jQDa7+{~>0;zkwtN(8T7+Ni1rZwNE9nB%u4ey49sfDQ_MWed2Y
z{a?WPSMJ|YXTX?%#Cmr@S2Yj>qim=1U%}tex3jVn^LL;Rm<{3$;bi8YBc>1LXFD(V
z|8lSaOdPy>;6Y~Ba=$IHf{YT$ft3D%ASgH1T|WMN!oNZIj|TrBon4vz9YsP^aR7xP
zYVfvpq5gYK|F3Gm-!c3*StEkm74eU?>Nged-x>Tvqw;4Ouivy|zra6f+JA}UpFkwU
z{*~AR{cO~TZP0dSwA17MDfk=QKY(I`zV+(+w+3ffmKF1Ivha32Fm-`^<&H=_aBVqC
zU!7T{b}bM2u&6YJxa9jNG1l2U{LdOSf||F35TE+}+e)=y`GEOq`X#}VK?KCI-9x3I
z)XbRVm|)RrdO1d&`9wi(yGJ$Zk0?RLBu3jPeg8A=UqJ3}fTG1tS&IUf!pn4VvG@vg
z5(MTSbQ?odC;?=?kY%(a`X7*_<G;_K>tAL7O~wH(X47pA%`80CqDn8f$OWr3AHsY?
zp?pRQk%4~RLqaKRA<T@ExqQYxh&k=KnBK{W0U#B9mSu3HP+&p^7(wRXD0^?;vi=rE
zyXSVvW_ef3YWGWXL_@OhsMhswZMQ}<TyKgkPQ_-6<DbW`vEXDch51o5l}_Ip$a0-H
zi<!bB1q5U)w4+c6W0JbZd$J9VH3%B%0h;bHt>ucA5hanKuWF!8N#(^CxngH<(ph`(
ze5scvmM{Y!Z|%(}d|RQ13nD=CRs~efkL0M{%c%~g;EP2~-#n^pOzL1sQ&~JdZzN$y
zd$ZbuU>g(t@?00KH0Ee)5U)GK+uUlvRjR>nviM{E$jjr*2aLjd>$QS?5vPlr)Z(Nz
zAEeYC#Y<sfYIT@4nLBoz`GzZc^$tR<NbMs}TTjpH9~VZ2b~XB|GqWigyYv)&EU+l^
z=Bi3u?w;5n4C&6RGl~Q}k!IVoZ{XhHhjHg*uRGruqUKRhROz#A@ne0I<opUJjV#>)
z9HShq^8#QYh-Xz+GYo0UEYADZAiC5EWTu8m@-ZLK&2MaI9B(eAvLvu)3@BaxdeUt(
z9VkQ{*$@%-sg<fXo=D}Yq+VdYpu-u_LmJF{!sbw46{cSK;5(UY=a}B~@eXi}949E%
zK;4i)ceu}@s^*r#^Z_5q?0n53Jxn^OqvcHk^%tQjn`Xv}5xY`}IiddY%1RceS}-^r
z3EZSq<gchsrgGpeT#^1_OhTFHc=haSO^szCc@hnpX675k((~`aM5|umr1WlOmPwox
z6k4>n=YBBarvJQ2rV541tyY#N1nLo?!N%Hb_IicqenM!Gmlq&cM|s`iQy}{3X4(l$
zhSjBhX|H;vbk{zXSR8wEpAsn3rlrH6Eo>Bq$9Nc<22gUb)!=YRFpmHm$!PD*P-q>x
zHnv}Hq84=z$DZ1J^xP0mqP^1iwS$qCLFvcUo5_nCAvqv11Yj=D;$$h5mmS&zBi6}q
zv4v#HDshVRp*W}7T5D_hG#QAd@-Zd3R72<>lkKxEo(oRry=jJSIzw?h#Z$HEn0ore
zC1Z;*!*}yB36nE8DVJ!g$RR<yF9R3d{F)?U6Fl|$wC_Y)xqhycq9{#nQPyCIs+kN_
z=Xl>NBsOb8BI$ITB!zKrxpzxLgtd2`V(?5ZY_Y+;dm;%Zi7gGO=?vuW@gw6MSfRQ4
zN{~Vkl+;bps)Uj|@$C8T_pY)Z>Sj=csSK7DO=7t>w3w%=0sDu(ysyuHZfYyiZEgvY
zOMBs3=SORv%r$6s)8L-h>$p}N61ERNazrF7Px=JTZKCLi4%|6R#OMYVn*Y~!9O!BE
z?WZFlS?ioW?n$gEBf58zpY`D+`vf@{@w%KIN^>jzPGqS*cjYZ^1mGymr(^gOPrW6O
z=>k4NN=e5WF+C)A^eq}vv>TP5nfj8%!XHc41$UbE(vu%G{9GnH%({H!62~i?(s0W~
zffc!DvPD+xuJ3tf<mQ*G2^sO8m6?aWgdFRafwW>!cDJkL#WWPmUlUc|yF9L}_x6L=
zO9f~bZ)&}+Suq6yb+~Y_%yXB+xpMv!xdsQB&*)1tbb-Mh!lCmu?F%to$MP)<lxb&7
zGzAK6fcBhffyxIW35?Bm*rL3As7jb0W1*?c<$To{-qWnKUoxxSIQugxjy=Q!4|1wa
zjYhiqYX%IzRg1`3)WSa->cY~2mYkZQ$Gub1BIi6Z*ou#1Z+c<T4g!aJNKnz1?5Swd
z{H#7(Kk6$pwe&hnT3(?mEtXmAVaw0=c*W=7B(UYr`uYQyovItd2SXPbmX9*FQmM0=
z5g4WM&-BUD#N}KS1Y*tWoND%%P$$)^^pGi{yyVjJb0w3^zigOf%3A19w|c~$R%aQo
zc&!v9%_Y>CBqUpTf#<z|(=!fZQdQ>LoN;%wS1%th>+j0;D7m#)`B*;S&{uN1(wvpQ
z+NPa6-#PWkl(4y1<kbAZD&V1;UoIaxvrPm0^BX4~+kZ0Bi&vFnwVZbCLc%EV{Yj5>
zJotH+yClJs1NX77fbMjyIaOyY=A~i;6j#ibqbUquJjMz28clgi;V2WilMa9OFjRV#
zTROzl25;gTzY~pwrsqm~W0E3Fq*5HqBv8S(w3tg&2hf*!3iAV!?&waxC|232psBd$
zG$>QGFE@>QAVzV=6%g&UP@H@^keR5Li0|YfWA^5KdWNY*N6FhOehor`glEteBo)+d
z0Y|e}D1n6Gv8Zg3L7RE;SM_e9>`Qh*B|Y<R+fP#ubK@kD<*a3A<Q|)xvVY!Uw3%K$
z4ZJwv+(W7gXJ{@z?dwkcL|*Q=6SyWfs9jch;hxEHd;bxfRGPfA7$HF^J;QoT;z{h}
z;2WdQWZk9<jBN-E%kv5Z<h*0zu?``vaI?o<lhju_y$Zw*oISqr64xp9MYuw8ocBSv
zF_{{Q^sl#U1l!A&s<qKe28EB8*v}c};23%nYwDWU3RO(BA;CPV(nrjUTSG1cDmk?J
z+BDtILKhr(+;bPAjvzL3sR(A?0dti|zX1ebj4Zz*Q=KH6{1m2I1Undk_Kv<P`97#*
z@Y&H}su*=Uv5}eOrIxB|FdqVC)$g1_|IIuFOsB}Ld=)s~Xt`!?0jlg@zab!3QSOWV
z_h)k>vme~f#yZs|W+5TJm4Q_>oxDgZWut+?Yum_fJ<<D96MDJod-n~i+~zf?qpdcq
z;@Sc(S(d&3oprp&VmNERBCY>`88VKC1e4@p>&_RiF&$upd1K3{U72eD{q{CqCm(P!
zg5Y8Vc;h`NE%+{o4kh6zL0d{~>)Fi0Kx9bCz&rW3=|EPBGyTJ8K_r2qAj>wE!ce^k
z3))+t<t6KV9+O^RXo!Vu+nO9;$sIduVzyzfxIe-*CNYIxxnC&b#+d{RikXK<S4?~y
zvEZ@UYe=AybKmzN&1iC7FIaF?0kd9m#x>R$7A7E&<h}-);F{8xipp)1eFK=JVn!61
zFQcR8)!FzLBzZBdkFWs-d{53=Q<o~tRvUlFYg!}F=u=&Jr5*3oq-fKf`ZQVQTzvsX
zol(76jA0a~G}tXQz7l(j;Wo!f&x5hFDUegM&P#Pq^Jp)c=j$5N3Dz<V5t`QW2~>%P
zFF3w)qeVC6Ja##MKRrBND2p@@1sttQm#>MJRdnHz4LUNqY*#rS`^AEvgarY)`Qf|;
z<5`2HjG>cj7eqFu6xsdFaWF!DD+__fEnYEbZb*B$Ki&LJ46p9MSG>~3kmunQ`ly@L
z;bvAWEx@tpmnJhuwtxV`wbv1zs6h5}Zj+Q<9||9T)AuolZ}gCkj^)uXoRX(3`>3qp
zk|MDPl+C+@Jy*#@p>RsZq$x8aD_(K@4@k*n#(QM5hd)knN>AK=OXp!n36SdWoVK)?
zkE=W{IYDQWudhx%Y#-Pr>tk*9JP-LoX&qXEiBf0tGuS(P#^r;AO14dA1=st_G^wM}
zo_m4yTqsV~(G$y^B%2@^m~NKEG9}C#^^ApT;+BLevgr*T=nHeq8aDMaDa^O14n`kW
zY-+J=dILHyYz}yJm1nFKS)VTI#$Yh&l<r`W(@uUdZ(HF_5z<*DSt|j@wZ+SEkM!aX
zx_lEV1--S+(Ffm^2Ade&+i?iDslkX`Wapq=FBE-$=$n}yWl<TI?z|BrgZiHQ)EV#9
z;BV&UPXzFqulun;`L*L`^?7`j>1P|AFzW0yqK$bp90C#d;RCBx^7Ps{#xXjwQ7FLO
zroE>2M9s7clYX%sZ{L~oU-1fM?MRr8QJpTYu)w%O?7&=FTHl2eonP08&JhKBC9Wr?
z9~nId>&wY3_eqj)hIt1L7?T~Ut-N-2mXZlJ*30=ypIrTwoau{<XUZtRmtrtqbk@G8
zNj1)V!1b)jy`xmLc@{@NPjsR;`d@KdoUvS@sZC^QRy81cC14h)xv>1~&GYG?=Q|+S
z_Av%D5NWYc^r>}}VaQmZ0fDA--|Iu26jR5!^9H;ph57^buiZGoSjZDCw6Va1rc3(7
z^Q;lD?kme};LH2QWD{Q9u0=N7^R>0weq^EpTXu5`U^Y+EN$sd_lL6WX`U|awb0Zt3
zD)L<hFGie=ss(5x*nshxc%<kwa^w9(v7Mdf3@O<G|MXJXwWPu{K;s3oHcly~9%nFf
zReQ`{)U2*PW+__OdAUpobR5zzI{dcM2N7r@x`uikD`B_hGuVYuXZv`ZnqH`*Zo}Wa
ze1$jOB}rR^thhwRnDl9}N8hzX<ZOoNOnpp+Q-VAY;7N-I=JFb9>fVbESJE9QQMRb5
zn#fTf=JW)+vY}{fTHBNWwXH(wlU}>9L-dE7`0E=2?jR2sN~^O82C!`boe3{BT8_rg
zz(gMUnY5n05e_=8>|15Yjni5Y(l!v%_egGRy+Zr0uO4*GA=IWTeDhWCRyFJ6YpF`?
zAXkPlqU=GndV3T_Q+mL=D^qpe<=%yIv(xW0oGsN*KrmIH?+kB_9ddt2PJHO2vl<d3
zMnaw$psS8^L#=06Dy{rJ64~Vgay<kev)Ca%1f)K|Tg+u_rRk`!T<?%_jH?1LXoH05
z&Ahbv_>@dA(WWC1xYi{VSJz}SJx8F8DXgtK^Pp=lO}hRC`;b^2{_)f0fosO3<&WOE
zNNGuB>6TdX*%&MYrdOZ<vCtMigfYa@YdNM=dTC7eRWT@MNe}5(!Nhy^<0#XskCLiz
z_Dp>_V51GzNP)<8M?&G{_Lu@=h((B!PC{tOz!o6czSNBXdJF@U23C2N##&{MW;utj
z2;c!1eHh7AmNjrG%a}BO{Xv`GKIzmc*#a@|j=Xz52)a9VEugQ@d)u)`Z>5($-=a}+
zFMs~%0>2z>bvG!zXO<G5u~cM!8c#|ZE~2C<ru+iPm@k8sa@2s$x`UlVI*2(S^7auO
z7Gg7BMu~*E-*{<(Cy!@f=j|KMlh*Akn}m(rL=u4BzoH&}uXARV4Xr|VsG~+e#${Xw
zT+=Yznb*T1n2947%gbx2l?H{jw{t*4zr8FHT-eYSOaV*>pEE?erx=qCfhHlZBR}ZH
zdh>!nawp$kSChZz;9vL&@fkTp-mB}!-iV&I*#b@#fjUL~7Dc7Q+UC&>wnx96Txz6#
z*UW&FKCmgoa)TFdB*BsVOm(3V0r8n@dX1)IT~J-f2lW%2TOk8C7R+@b>JFwrggWA@
z1=3S(-Pdy6*9cSxJxmXm#tYFD_Qe(U;g~aOZM?<$=e7Ii!QDWA0iah}_bP>F-=GUU
zl0X)p@^`i%nU9*!$~s0vSY#mD_|zPpe4VN<#!!rY)fdbkfYX0D3x5fl|8_WZ`78%h
zfE1I-Kat#@%JN4DC{((9fRCs~-rKR4egP>azk~ql(JvwVQwbpjveo+_{-Bh{31W-v
zxVwL|<*%Ir{DDt!&DeuuMWL%ORmMaQ6qHym(NSgz;f(<OYxsM$!Pj0BZ^RuG(FtK2
z%M8R~M-kmzsz5xV7tS^o2E+m*feVMd`XDVcvpYmA&|TqwBE1{wdrE(XMhnMok}ZEA
z{?~u_pR@CK<n(V$dJhT9ZV62ih5t9E{tqhsfAU<j?<o5B+VS7KI_8fcN03kv4E{1U
z7fT?o%LRcvFhogk!#(A%8n*s38o6e^EFMXCV5_g~$KLIH21$cfJbrr!L>vZf-$Irb
zQniAanSXBIGTE7*uCi#RcYSr3X#^*YEtf82T)@;Gcw^=kixP|tA&?h+H-Mkan?Cdw
zZGP}pIlXs7_Ue8&n)gvdILW!<{Mt0qQ2`^Hvpebdu@(%R&IiQxGzVfmth~j<EKgXq
zHUg-IxPc1l-kQfIR^g^0x{A(R#_$v~j|kH_2sS5$I^kXwkYd)a{+9DbVEQhl?VK0q
zMZH2LUZUy49mq-5o}pA8NY?B**s7?Cg$jLVP4M0I)JL8JeQm54o_Y^}&7~<`0&+>q
z0Ngn(q{T|U|0aQauCU6*P-*5`{9_y={?x<TNDmiK5JrdG6fo-4Ia%)-PQKJF>hh}s
zMg(=aCi_a#lyz(XZ$ueoW<dsb0HoCha6v4^-Ej+N)yrT5Km4Oy0{+v}F<-CktoPZ(
zLSqmqRe&jZVXr!Uuc3$cjuxBXtfS-Ct4S}zFJ7hK&x|?g<%qEjoKJXM4=xn4rW7~l
zjB8F|bMRU_H6SA5c)ge4gZP3fRB8eXS8b!r4gRO$!kV7I-p*=8Sjo_-K-5`qw;C5E
zvM^`G9#qM8q1BNhm5hNnYA?xHV^VKs@1>e(jgs%J29hM61mI(K)`&`zg#olA!toEm
z)Esx}+zmXt!ahD%j&yfOSML$E=iZINN~<0AFX$&tD{naW?#>faYN{`ISmlJhW@!DC
ztv6@iKY1aH{Zb<kcpzm>W?{kkcCCLj!GdJGxY}!7s}CoH(I>iwn8X_Ze5~c?C*#bV
zUGwQngY1Sf&K~V~(8+wy8^<bWZHX!Kq5N3vFC<-WfkzgLY!6}cb3om<(c2x*R*cv_
z6!8|>+=CMox}Cw*$s=fbmPNLLq$|@mTV%bU^I)c5bH;mhRvGh-j?krcmIhVR?UM*d
z@(L8WVom3E&Zo$amJ}&vo%8sbIA2+t_8D$WdW88VobBX8?~4M=A|u`nkF5j95s(-Z
zcSdYq4{=}&#i5&Cr&rZTCtiMV(o?VNxz_&lugRVAi%WiolWu-sR%t<|(8Nx<kcSs(
zn3$g>U$X5PZa?#~r23Wb;mU`_kKM;Cq<#vyoMp0B?y<I-Ea0}=I77Djw_CzedTox^
zA4=BN1I}^dL_1gmV<#!kG)HAV$k=c`GC7GaPX@=^J7aZdyrEDe&*pXW`2Z|*4Qn|q
zz+Gy<qCM59NBN+>%WBZov6UakzKcw<DXEc!rZeX-SLAi)6Pr~T_z*}Hc2R!Z;k1Qw
zf5**;5E9!AV|dN8gaV!mv?qm?rfa*NYO9uNB6Dw=@|IC$rKT)92h0`|NPEGF9#h-p
z?0lv4Eg%To1n+u0QPfd4R6NS;RBH(B(%mmZ*LWIiQ&}lBWVzC`LVMlf>RSLa+SU1$
znN>?3HNCc@(KUyCIWw9cOQFkL=8#}ZiU))|&K3~J<FF$yG!WdZpIY<XWRFG#t>VT`
zE&%=mHzkv}$YqiiOxn-N9fmC#QWb_haaf<Jm{{D9UTNJ>Akc=IRWq(J%K}2hA>@td
zavtUssl0%|11o0Skz(eNS~ez4$%kv9>U--5WOf>}<8V%(El<vvz8O)>x#^*uC3ELZ
zvz=>hqU({aerRJ1U{+sCe*P`>vVzQLUG8a*iirh}@iXV&rKD{3C#DxP-<S!k6H{`<
z@y3(y*<WS1+23QTIiiBoCO`VB&|LqTgKwSift4l0nhT=SqdZXE$uGu$*CclMl}VoI
z%!b;qlV`lPl3BYokH1LN1rA3-5?_5y9P@+9bprWO@_`oF`{Sa01zBU=VW&T8zBfqh
zW5$mgPGuPw`Y`ykGd&bP77oOeU3Ye3Om%oMbY*C$=W&Hpnm}D)J3q?RJ&F@oEIM=u
zxQl-RP7XggdFQ<0)mIfNatT6I@zy1R+?FBfauBn%Qqx11qxf{FqMpbAE4N#y-&GxJ
zF<Ulk9JcAZ?183Jp)BTy_Zf^<1DYK(Pk1;HCRZ4uM##ByY7<1x+<arAkf_0Lh=fEd
z^ujtO@-F)(TvuY!RnL-;jz%VXJSw5pl>ydu`&?KSgeX2-CD-T*D?Tz{7?&lfKOH5Q
zkP%-648a7+X7#wwJaJqx&h^O-TQ4l7t7ZZh)(#opMBWcIX`)MO>z}yBM5ov$^IDkK
zd!JvRI=tz;dElL_YF;7krf>WO%T_!ihEw{S52`YXKxY`r9OYYCjYUW<<Ia!ojYy~q
zv>v}0x~6Dtrbow94KNkVTI_Ezk%T(O1|cdNu6#RH+E=PQobA6(pptq;UAfUYQIurF
ze<KXP+>7p6lQn<l<lVKi<N-FVKdp~n@ZVk*CF+VQcs(Qx!&B=#QJOrDVJ}1D4q_e)
z)^M!|RO{KFixhpItWJkr`Vbah*XgQgGJKTe$UPIetU=9f<BesYJ;HQ*rWn%h*W4)V
zF|sHe*fYebXjR;4cTD@xWmBJ-cX}BXJd#eyhR4S-y#l>(OXD285EUhz7K$tp4~*5S
z*Yt9~yPs^~V>Nmgy<b~FR<8>q1C=-xy6`$S8Q~5gq4oHJ)iJS7(BZ!I?#^kur9SfI
zOdZ4fnZ7F5y1|A}NW46-A3b}x@5|a3lZ00~D1=!GvxwRoi=4s(Bg9iV7LeF0QyBx(
zJk-Uvi{6;Mx)PP5!j`<m2x=}#6FCd*V4}@lDVqF<^zNOLbIL~J%gswdkNH>*C9{c9
z-gp<iuF$1ekcLT9Md`7kANS*36t4v`8I<x8dr6w$v=<9|>XjC_yeljEiYd}cgriTS
zb?5JMSSy-w?782Ud7-`oqpM^xu!pG5-tLr?GUsmiTTX<aDYG(5#r3XYVtLnJTa>+J
zwPF~#A-4e64|qz5WRTf-{wS@Cy$F#r%6M*3h(^z!gM`fD)dgDu$J{&$mJizHr2{4=
z6%&Y_tjBX3IX6g^$x=|}=Y{R%51U^SV}32`(G?__mk?KOz4v~Yr;UXLkFSQc{QWR@
zeTRnuaR`hx=XUQ(>{Lul`nKnwAvP9_0&-o_4Yxfl9#X)bl3E23s6S6xxneI9iVSpT
ztT~>{4IdonytRMQw;d<H?0sfv;d3)4(TcVF;(V4uZd@qnnYG=~L**BQ^y0qYch<~B
zhPQy$_P(Rw@6@KC*A_4}E$Ey0ZRjZ?aS;jay8NxW)FX0Tbgj%=L_WPG<x;s<_qY6e
zDUc^W*2JNi^y5l`a|Ylt-!n_jIDRs7uF-uXWqmTvfRs>>zlg>;fAjHcgd$ngbwLwS
zr9s=4DS`S@?CYf`C6-H7Ftav^*DL{oDKp9!WJYqf&xoqvO9)k2`t+ehHdyoq8w}|s
zo)4Jpj)-7e13w2xKTg)#(R1R$?T)<$J_D2s$9YY$1QOnxV~>*2peVl^74E)b44TE0
zrU!c^k~_&}RLnr{$;)@LP{>)XL66;Is`5-na`QQiVb9H+!v}CPDL5=R=xlq8R`^&f
z*B6BcP>2N(Gnr#n;5}%HQL0OJ8O`eNw1@{-b6Hqs((r(~<k+_$hAbj@*yI%+34u=4
zf1Mlc3W!v)K?0@iL+YgV0jdje2#Dj%RJXkjr4r@2K=08k!K$4SCmJb+)J^nsq}P76
zwg1=sjc!tveaXA@OQ6>l3IXBKTfD>a+AN4Tq%(8wfik7*{rU6FNGzPa=loDd*y5hB
z2o+8g^{O)&_{+93?o%bv`i)9*>-Me{kIW^m#<CTo072f2-_j$yz!}b_+0xLD{ds&?
zl_@4jJt`32m6Pt^WV&In1vCg=DtfYDiUo#(5q1_}HAr{>x+epETD0Wly4BV^>@G(h
z4uI?XkjgLh4(EGLuUH4@zL)z<YoPN}xsK|0mY!v8QCsTR9O=p_y_)zWZhx)#M~{qK
zS8WBVQ7DdQY<LY~BmT$IV0L6L_HJgtX{?v58Ix=QOM>_7sv@zSn=K^>V|c$E+D{7|
z6@R4&yHi2wZ|LUl&P9YP#yzaSSgKVOE|;1i2{e%6E+wJ<W0<-`J$gV^8xH`j+ie2K
z3zdZ3T?LJg=$Yy>J#Fn0%u%}Ps_s_Dl>!5)-QP<*DYGrT9T3XGtc&Cn#8Sl|Fo(gc
z8beGkUa(L@?oT89Y#Y?J2HSG-Ry+4ugOdrxDz|mguuvr-Baz<ebRZs|+#wU@isShQ
zBFs0RFAQ_NB+>)*$qg1y!>)D${0s6XpZ_GNZzst2PqBP+Pwqzi^5-J{8Ct)B{u@F6
z63)M)a7J)U!R$psWF~?V_i}K1gV~EE?oS}>BSVd$%ele)WFKQ#_D>*yJ4NH@sLhw!
z;5#4&)<X~h1HP+MfzzH>K!ktx2>W(<Q$?|S2i5K(o4&mzz}xZ)zjH&Allh%VIef@>
z-bVzV?{Wyk{zCnimB7Mwag+8Mf~B4d+js!ZcqxOASUS+r+Z(Y6J|sYufK-`Q?rH|O
zjj3>FQtT=Ms4{WJB&t)P_))C8FK>u%I_0eUs)!%MdlUb$0l&?~k39V@gMYUdkXMlQ
z&fFq#Q1%~uJA=&sREcegi)qYnyKl38R6A8Vcrp9F`SuWV_q^lnQQ0qeXOs%tdPb~a
zFkbImd})$LSOaARC_+92P%q=$hf$|WCc;%FAoLFa(8=K7!?~CE`<EuU$I0uhhfM{Y
z&CTCA?Em9-)c*4<pOJ^Mmc%|vuX+(Qs0T=4!TAV4%3aFc9SO7*l5&HC^&_T<={6oG
z!3_h{8(^JSXz6}YvbHn-U_|vsKZ@w?(c40F_GsZCdU4#v{GYw(s>?i({IPoSuhzPO
zo|(i-1qU5+kCqwqY;S9i_LEj8^&d+1TQ9e@#qyk6x_pFA!y@Nf_x*!bNAke)maTYf
z1+pBvy@rhEJ3Tz)S=F4+J1~{I?lkS_#J-f1lXO}`)neRHqFP$rjeyH*+A1iWUNt=J
zZR<Ua`fiW3c}MJ?SCX}=MbMZ7T){Hc*Ig=Y@7}m`o<O~Ly6<w<<fZbX5k=3vt!k1&
zWrowjc&&!j9Ti#t)12~?_*vGbBB!%xs}forJMcW3z%d3BJ6i)vm!{TgTX1Q850NM{
zuV0(oiF^Jg)tL{(KEPmoIAM&bj<-q)C(v9-W!-V5>Gdfy$kF(SXd!p+nbV{it<`A%
zS#J$4VBZyRCzAPfw*X5&=yhF}L_F7P@U;24Qpa|`mv+=<mqX$hCQg%+fJe$lC25le
zT8KHW;$z^iU2(#FKF4g*0k$C1p7h@I&;tpr({B3)Aj!}2neDYi`>!6b6I?HlVd6PI
z77$KU*>dWOT<53!^EXr;8zJegtr5tvrTksN_GM)Jg?Daa2UJb~;Ev315!AhwA`<=I
z5VwYn8uN@L42gRMMf^G>g-$0vlesn8NhU=La?B>wK0J1hGV1hU&#=TthYvatT?F!1
zof*RfR!lC2U45#4;^8Wo1n8iUzRwx9Z;)nZ!aahv%DhxG+w;h#@<}YP$I?ZmGvidX
zW!AZ9Ws5iLE48@X*PD{oBWJs-GqW<lmFLXe#ePN<_3fG`+PbC3hL2BN{5)8$%sphm
z8CF_?d(3hU+_}fIA-2&QsdUy;|61_4P;5AUq|WwowGmh5AU*n-QHtH_*gAn)2+2vD
z^bw?JB9P^%#NCpt8^X^AGF%Qeoi`ej*+99lCK;}MdKr~?bVl>Y<{UJpC9~!J(}w|H
z@TH@&H*TqBb`QHKPo272BA;+EBKl&_DiYer2P$*Vx~yaA!-2uydn<1*`|eJf{HMU4
zC;QEXM!_E>xKk^Z)IM*LDYge*sm0f^cs^($g3_rN%_bFKQR6eZDEEf5uF0p|D!Y7J
zGwh5S1P2B-ax&F_YntR^lF^2Gz)3_^3SdI)bpI}0EpeXNSO;O!1D7%W&6FKDgY|tT
z>!1Bex7GW{W|gb9{cds}zOU~UowVLKy)o&Tv?K%jgd|v0U+M7kHec~<MF3g$d3h!&
zB-IW_$INkgFB7%y=Y1)FT|0kW*xu_ZW-^XD8m*{8*=zs89&<XK5btFFX2AUZ66+Vx
zBawQ~lCl#EW?<m5)Lw306NYeq&0_{E2h?X0S6mXj?MVPj=O8YH$DW!kPeX1gEPABe
zR#{}-z;Kjvcr&i~R5c~(7iN1@!V+!7!Nan_T|y0>EPjFWrq`}gM<0FD!X?Vv$G#d9
z|3WW`m*4uBve`a=>jxH0VOv0p3E$YwJ4#!?UU0L3JUd$_es<rw#m44goq6N7Fp(n6
z7dEG^Rc&scXq>3~@aBxtK$>g7YFPc~3TD0)n=l}C)QJ1a7fPV|Zho?i8%OpmnqAlH
zxK78%5~v&fXU<}WEGs(jkZ>WOks@LEX7<71!p_<g><#Ap>95|Mv7__I`a0F2e#(VF
z)u+#hj%GhNxM#Ch_bs)o@!pS=cl_uY4_#)`o<XT(<=}YZmM`*uUFtS9J@)zDan{jG
z4@x_NW$MNss|t39iCmbjWLYPWYWVf|5jfHt14G|bn?YFut+k@?imC>HzL#1b(;Lg>
z3TM1)ERu_|QyclR6{F8{)$Yl-0pM;MSNZuCQ*=0G)})}M{Ph*<#H0F@i$_tswNi%(
z@*cn)5g*@F+^f8>eadGaOzX~amRug4eXKCmD7_R&_8v0ZhZ8kq@378wijAj{H<oe%
zy2xirI)g=~JpEKjR3`M=rX}FvJ+MW!si{kPS^V|#vFyr`dfj;Km|6jwO5a(R(WdTj
zpppL&BYR|Ha)ufGWlx<A9i#AE=0}x`Pr}y`^EV1IynV<B1gd8NDj~g#3dIy{G1tmn
z(bDbFa&uKO%L{}pfKCs%+gm>XbHX3L@@}kcb=t^8sA6<h#lJN?_Q=y)tYoKha3bRe
zu!l+>Ra`H7Y1$DiGD$WWZnm>JWIh_P_bPnx<=$$H1Gw^N+A3P*uN@wYfE2!89G<;&
zc*yL7IOEmcyUj0#ie6QT+~A28<Vo0Ej>aK_bE2AdCYa@9RzAJI_OA5Jw<5RWdTo_;
zc-c^XW%G@pOWD}H*o>(+>I_FZdF8OZ931`J>FBC?8?EF{17Y{~hbr%8h&NiKdFn@4
z)Yf{B&cV2Xa-#acJ#^)L;BnI)3#<`X*Q4rh%)PGg#_^9&>r5L}-?2()_LJ9+)T^mU
zn-%w!>lw$wWb=|%m#o$WqUJ4vwZ{WW)MCPlAEl*Ho=Co@Wi9e_@kp1|Isu-8M?$gT
z={L<^E_k&3?N_h=#XJIJ@6DH_dV@dUu8w`+B87}-g{F97;CpS4i%aj>-Nw2RBin;n
z=qu2uFDL}J0|VXl8|z2Q>^8rErwS<wR`WW^098Mow*LZO*8fA~15liBI#TstwR7tG
z**WR=5eV?YvLtQtxSH8=slUu*GHwayFxk~mB%h%UX|z5^EkEdZ`@gZP1O-7cCL^kT
z&J2OOzQLtnezJTPD7f_dou;7Ve2XXoz(Mpu^8hpvATp{3RwZxOOMfg(e_x>fk9)@T
z3`!5(81QEC07_BTs}`5|u+VB|w>BFi5NKp}YD2ta!vg_tb234(We0v-XtW|$J{)D5
z*gCWR-f$po+qOz4?{inFUFpjW#=e%^cm>XRT4j-(5gSYM$ss^alh|v6ewNHCZ$FDM
zK)7NDSOf^2V7qs&3!1FG|5h?MsS)^`(cSOi3Y2JU{w%k@3@&>JRbq7k9gvxeN~M|-
z328hjvNk`R5oi!>KuLJ72Dsn+k4vZj3h$9y{lqE<Wk|%Ic{t}0j)c+)Ok5I}D9phL
ze?GVtc5odu?M}CS%x(KvJVzi`$qonqv;IGVDqe5&zTOxF`>6ZLD>}(57Dxi+H>1XV
zMvYd#P4eFjP5<@A0Jwf0DKK$)Tau(DF)W4uVqNJ!N}t`vz^>Oq?9`?u0h)iY5oOXc
zf#U<M8i>}F=L(CS1}_;6ljE<<+*){jJmSD=B^q@5uX17Mt>Z{+`YNR0EH9DFFGWXM
zqNSFUZ{=e;lrN9I?JQh%oIusO&&h40TKnm#Wt(F)js_c{kI4x~9x*4$aIpb5MLHQD
zGu^idx-DgRzV2ag31b&8Ik0gyO&|AOqz*j)Esw{1;!VuKf}8}h+JjD{Jar}ay*^*L
zHO*cvyNt<Q%{h{L4+|~do`nF%pt~MP|Ksyq{;@6KGQ`Z|kvx=FvSHa&ol*Sj={VC;
zCPO|9hm%MAAlMjwcYgYpZ)*mKZOy;hOyqxheo0S)bKL8Wvnzw)fRNRl0dtWfb5I+i
zP8w4vKvNNSNSKQfg{Y4csBgt8;k~^<uePEwO|q^kh#_8D8w=#b_ND{KT$%s>g4f77
zt<G#@^RH{(4(6syqrvkru*CBl>T_jMjG;5J#M!F9O|Tv4M@Hrv3;vRHvgU!l0y3_k
z=^KLWluO%%?Rr7?Gf1GeJMwoZzk>gbWrF-Kx>M+2#S7V7t9SJ}G&V&GQ(Qf;`AgAx
zY{6!ADNc?(Fu7Lk=L?w#$Z@YA?|AS4m%SmxfYkr<fIXSUf-UAmGaj6Sg%<xm_P#r=
zsWn|Ubg2Rox=5FVA}tuCNDZMAQh<O;hlC<cnvEtxsG$h~ks2T&C=j{@mEOBFQE3Va
z3RpI}b>Hlnd+wQg?r-j#*|Yb(r_5hrt*mclWs&vP=Xu_@<{Y$tFwa7o3*0K-a@C1c
zr(doT)8_0_E`%E9b=g;6ddp)uY3>IX(iN@oMD2!uM0Zq3q_GgFEm=mkvON{I0%FCj
z{#P3K?@K5C-t^;NkN;(^++0DGk!3jcvo@c2&M23o&^1l%h!S7QK2#fka6HtExfX1Q
zz1ix|<X?y71hOWD;H5dCEQ)bljX}Y|r`^|r3<872qP&0??FsO7s&p^FCrRZ8_S2}X
zLG#ku_1H8Og`rR5K!ag7$*Yw#0IIqMtaZCq6aQ>JSfj*&?F{I>L|@37&=BJ*=P~y%
zt;C&dYr~C8DsAKRvwipTen75;sRkukK0S@C3}6&$xf#W%_N4A_oTJ9rTla<`eR5)}
zln41wczb*qx`;51$8~Z9OFKESU%OboPu6)>DfvE7k3>ex(kgpUTBS1Hu{!^0`i*Wz
z-wV}btYX2ZVGCcuEG8;4827r9L_!<FTGAf$B%DDF&8u@neFEx7<_>96djU>V;SZ_v
zb<hfH%T<ZOPzU8a_u&}_ma2>j&kP%yOLs@>F}_NgkHfzt?0+*#`}an3|2*#hcodmn
zzXlGCzozy8pvt*zaDm!KCe>fVWT@7u=TP#bk)W8j{xQVlKaxLNGWtDmnf8mF$+zA;
zyRcm5WQIaL^6mVwacZIAQHRmFD4B|q$)P)Mg$O|`e~PC6j!2q?R3x202DFtIJ#aE?
znE`MZqw)uX`?cqqPazzdG_Sro$JW16zf`{On;frYNKopvG&Z*uIwcp!)E7{hX4~q(
zDW)yB;l;PYN{o_fx$2&JJqf+Fnh9ZI2e&Bph8qx#^|_kai(V_`7Xv=mUU)A)doMe0
z|2wEGtPyLgdE}Wc#Od4F5or2qo0@KBZMpQGsgO??TT=j{y=3$5;?*Z$9nUo$JWKdz
zbNTc{lU=v`*$n*Xt?wRG4f>RHh&nGO`}Vwn|E3ngf83+<5^IP(WKv$8a)ojRqowri
z`BtO-DUwhdM~f-M=61P@Wcez^x~8I4Xs$3LskpJ%;_TO_sKTPrrXA0Rd5crloPM5b
z@ub@yAEdRnsCR1AQlC5vEZhc9q;eQrZ776G5t`M3*ur0tBME;{Q|#z3&+5Q2VL~5k
zx5j$s3*Oq4u~An)RLMeN5{u1m{SPBCt43X^Wk=qvcWK7G%r|VoerL8bdXJ$s?5ZiU
zh@Ss+0l^TbOuy{FMr4cvUhMlJzG!s8PUbR3lldnjK3hQG^7Veg%$W%H-TX&4tDU<X
z3#@8tYw4RjSt4Od%=Bl?T{*P)MS9?C-0Ia|0MQuvl*ta*@wcvasW~UZ`?di?zW@rJ
ze&3#)`LX|9S?`DI(Jxd})VJY}Wt>4zmas(w>$5B|A+C|z4-<EU*+gpVJ&)+YH{*0%
zZalw3vKUd8YFRVA=x+K6-(SX7w_|jgi`N*rr0z1C0dSrv{9eX4Px<_4@53W(a~<g5
zX{0Qbp@en!0u6wBu}rsZGUTMRw&kRnz{A9=W-2bK!_T1goEKeg`M;E$V12g7dS~O!
zY#8j@@pgglYv>jZc6W{st2OtLkj{aU)i@>E`u0+rFYN`Gt_&5euV%}f6@%QpoYdl+
zg#|>CjN%91*&=fG!(IotbG3Q=0+4FD2FYQxmx6-7*%G4|&ox6o^aL}_l|eU3MB75+
z8CVUT`;1$iOclTQweKrRWC-&r^*DZ|Si+}DjyX<gFstQY`V#*6)iR}TXP@`u2lK6$
zHSap&$M0Oi?YGIsN!|*FaoJUU4=~8IgtP>OoHA8OO^>RNF>(>JF!E<{?B8s?1R+k$
zwGbBqcVjX3u>cSb#K<=OcjnMPw}0RJ!JP5elEM20_=&@t?>*~e#m+fILD~^XX$d;<
z3_3nP$GyQa=2)(o%oE_%3np3)&gq98pUSu{XvhIb?Q@fI;KsA+qt^Q51%w<62Mzme
zs{C^qj|tyuEoWuv8athQz3FMEx@JF(CwZ6c8ViF!=(r+uo1pP{$06V6`l*MZ7#mG2
zyh)2?3`&LZ2PZvfBmokv{k_I4$Fxv!VVV>;4eotl)(~@?g3>kLPdRV6_1;Kyc@3%^
zKEtPsju#kicb~oNQ4IS!!6q%aPl4C%thyu?tOfbsCFvxfIjW%)s%7SCoCedtsH*Ju
zMeP4I;ycRRszMVw3OQ74;#hIGYJLf>Ub*Esg74x22+<M9aHjglFnePc!EK9B0W}Mn
z%Zw$zB!+(rl~LCVi3~8kl6ykUrw>nielNbQ<~amj!b6yESExUI+6}2T7c0gn!D$(l
zO&XVR)zE~b{-QHsF0?06n!pH*;GUt6f%+Jv^?;-Uo0al~ch*NF4z;tyy`&>*+%@qZ
zF`8E82XS~1!f1fjCCvUD*X!mOskJ`+geQ^IFjofBrFCU>5K$8OXRU$+tGp(yVy8UI
z8YfH6+=<;rCr^Ygc32f*!=L1$Zl~fm*Vm<t>z9&|QcRSQ=Ia6wPR9rSfr5gq+J$R5
zFg`6pe?zf-GIVT1k~mjhfKQpU0C4%}cV=?d4wr4?dJ9K^4eUlhH<PRQ<s|4~3|VI#
zKtz}2_;8k^<yOeeOwQkCMp?#~-hjw6Pfq)37n|=ljXcui*M-0>q;>m&vO|L<Na0nB
zK=I;bybgbYvgTG*UJ&<GOO`D4#{QiV12&P?8_jm(XZ>tG^&*NHE^%)}l$p&`p@Z1w
z2V@;6d(MkOwmkj_DVK+7C4`eQypVH+IURZ{+0f(QUMj6e*5wRoC>s#UAb{p*Y{9!+
z!@doQ^R;ky-uJ_eTF|9hSYLo7qRCaJDf7vPgv|Cj-l|IZ)v`2=v!n;MDz}_?vw0PV
z)805;KKELTvhNZo#(ww70!PV|9c&SoQ7Mo-O$ahH;m!f&dowsqe+c&S#4i)&zn0vv
z0vGb^)y$XKe${bRy*@o;L?2FTX}9ePS!rP~v05%heE!)>c?)A#cH2>%*Voa3ZR@VM
z|NT}VMps;Mg+8RjV*kzj$l)66^mV#K=wZlF{1~IWa29&el++j=`Z<A5gFrI}*s?wC
zUN~QxfBBn<8rd*FjR0sg7+#i&mdZcRutJqk-Q%?tagb&1u8`p`1<eBKn(T5!Yo2kI
z;Pa(<3z7pHzoG=bSM;X(41IOHZN}DPNuTpk1t@EHx^$9SE=GRfZC`$v???d5{Fq1&
zYmCDuHS3RdY=f1UXGCD4i~3i$DKWZ?#IWV~WF`yWnOScy3HI|9j0(t%IN@GTU9QcK
z$)E*v_eaKrWoB4*k^bYyWBC1TNlz573*CV|ZClK-QE{;%W&a_E{4_ZFq`F|YpEgtM
zMiM{wrR~@`w88T#&(XP}U!g_6W?}zGy!y|zf9w7s{-OuZ=mQcMeE<NXy~=>lS!F*e
ze5zRC=NGPMe-fg?qNQZm;(Ix&;8jwzs1V?4M;PC9w))jA;e8-aW4Q!Hq&eRy()jq^
zV!hkaPOAQWzrzXEfJ+ieF3%J$PmgYk@Cn7SgHJWurmy==kqUAKx|&3ehZ`LgfupL1
zi6w-<XUu3$QE){b7JfYipf@eG=sbW->>@MTSJ3s`Pt=MJF@_k!z)R#}P{Qkw@oJaL
zA&oL_ETvc9FyFqv%Ieb>g?h3p%TZVp_SMmrC&%_4fbT3<rnQTgM3ZP#FTm<l*vPps
z+TyL9(4_q}6E<}hD<i!)cIu#n*|!rkfa__Z2H$`+7c#cqauN25P;L$YxO@JM$eLw2
zvVkyniKMZue7mM!u4kzds!fs&?U+S4r`DZ?VXuEC{@Aex-E8(v-{Y)Qy8O)W^K?&$
z(^;!W->a^7S$w|rO?xub(HtJ6ke~dj<??3z3oA;(^RwcFb0$s_UK02$`Ca{7n@Ppz
z^Ne(NnCpK_rC_{&dNP15!dxsn&Tp#crMIISNGnf_Mfq@=6+T0T_{k>SB$Spb?@uSI
z&j?$4%ZvjZyho2MAI%f5co8wvbbbl?7-D5zYjnttFP2qGM(mT?{4Vhzg2G3Aw1o9Z
zkG%YE>8gdcRttYRWw6oA6HIY*>tjDgnz}6Ec7^KlK1kRqp6~#Ukq|D@UyJT$zoS^Z
zQ6fxp4M<AnPme_h6t_R$XU92L3P<115z!qzcT<85D_j@JnrStqugnLGb;xeOWTSPR
zq&-_4mq(6ph>}xuLSlM#l6`3R`&nfm^Kvj^t$rxt2}c1~nV4VepBZ|KPwa=OOZd{b
z)^0k9euP7j{?e%K4%Sk*MUa1QF+J0WBDk!72ejq1tGKkE`6(xM&QYZU_Yfvi_!3j_
zI344Y_4SFe^Aro%oi&MzmVI~BwL>(ABC@zdSyi;D7xhN%DFr4XEFNA9ovJsfuiCBp
z!v0Z}4Kaa`KI8+LL*@bI(wZf?B~!5IQMg0NY~VXRe^&ETE3|0FAoZiw-q!PT`Gu!A
zf&RCsLgERbCCH8RzNaK&k(An*nJmYf#<sosO%10bsO*=xxCmV4dRK?L2#U4?u-KVo
z-(X&+T)qAW+HxR<N>df}pr=C>1@8G<&+c!1|N1YJ<>sRQO6L7veXoD%fBlwM?0+6?
zCiCBTu>YgJ&vp7=DMEFg?-8iRs4`A}h9f4u_#XQ`z#d96-EraSbynX7+Z(zSjGv?d
zTv`;$Zbcd32m9WnN@B29dv)kHvD4}M`SbQdOk}I?l@fecFC$NSeU3S@MymW=x7VhR
zIv?;3RLTpuV1|l6_r>rsS8M3E`{@`HH*4`7Wd8%Xag{`#SO>P8TkIRH-j_@BwaW>;
zFL*~CPa}zK`i|VG=t!1cK)_kO*=wJnl*lyMz8}G%@6q~)QHMpF`MZkQ9^(v9Jbo`_
zKMq>^{>Rr7`1*bQ!skC5D8-07a(^yk|E;w>2meaOL=+SQRX*E%arAtPIrqK0au1X<
zd-X0~?bqaLlm*{qu78ON0}RI_!Y0l01W<1+v*SlqB(6=wr6<nSX}Z7^LbhK@GAnna
zZwP%u<K!~Dq?Lf;=O{{U5moa<-tHc9^X|=IQs=W!>jR)}{kK%^&~z^UK+2vNV9Dki
zh$9#CY8MPEH!wr$42VDs$X-`KZ|yI3;-Q((Mgy&NzRpD?zJ_Qn=Y)vpR-k;Oym*kC
zGG>%zv@cuA5zTPSo%~US#Ou}WUr`|OB~x3dg9hPl=v+hlVJ5ib$MXPF3A{qx_f3%7
z@pTm9bipgi)1Sv5&6PKsrDao(bVGmxPiA|+RZ!1m<ze(+4Wv)0Yhi-cHQ@rCD30B!
zMMn8TsHDhJd<Av2FW}52ZW#cE=6CLTeRcbQ+(l4Z{HXQkJ~_f&ba<kX@Oeyl0VOP#
zR16U!xK;yjxEGM-V{^q1Ze`>3P7CiruW9;QSc=wa_bjTaPBWz=HpO%y$cJFFkV+Cp
zK{IwN_dV%;Lqo{@nIQbTo{!}0Wg;r08}(uNYSEEC99c^u2*Ua(V%mfG*`nd}gctCb
zw;)J+Emb0YvwoDjOGFakd6=U`hGLr<n~g*x>SS9iGv!|cqx%|75V2e;*2GNIUBx2#
z#_~;aZne+&43cSonOzitR;s8q{)4*S9KTFe{z0ey@80zOBfmeJ#J@7f7`C#O;@maC
zO8=u0ipturQ;wOHZ%xH@IE+8miW>_R7snG?<)EUnMUbRiuM#d|t8?SN8dE>CPHhzh
zsHH?&e+G%!n_@OgY`b?HCKMIu0wav66!oS&I5{>TX)}6!7w_ug?UGvZxlHYR=ZUV>
zW?tN&d{{YJe^xj>o)pPlLCAkTZWRv88qlR0nX!kCBB2}`t7%+oI)U;udy%{sZ`;db
z(KsVs+hgHw#ypKb-Z*lfMIvy!7Q>4z_@t3%Cw!%q>g2A|TNlo7S+~5w>mk1l*~p&X
zmvt}#764!aqOz@{UhPls&`h+|Xg$X42cwR}ybjsA;UD+79&u%?L0UcnQx;EqOPF)P
zMT3t}s|Vz{s>7c_Bv%_N+5{>9{ncpFHpmJ8i6RDlOzr`0%s;TucCK)`S}Anz*nOQ)
zf_FFd<!qE^rR<$k2#JRQA1P4^_m0$<o-7uPjfey4mJiD6y4>z~;QyYKFMDdL>YMJa
z|K{-&@3Rp7h}t_et24+TF1Yudkm;c7&y+q@dv&cJ$4Q^dNe<RPgt`<<*<8!NBMaz3
z{{nypEi=j1cBojp6DIPC*zOOq-2VPHNb{xon}FLIdS{tCp%0yBPFRh$1`H9JAICqW
z)JugfV71QdD3{{(qUUuErt*g@WjmL?7jd2^lbYamoU3=;jy@-iaPTPE*dC4akFops
z!Vo5^Se2ub4WN%VcYY$9f`$TgE*7=ZVm!PCckGfOx&vhG@ShBNfz{CfBw>^y`dfY7
z-&n^Gef+1r`p*Y|`s?-zmEEV1E%OFH?dnn)=qo+Jm_fXTt-5&A(@6{{VT3txy7U2q
z`6hIwzaj_RodoG9F3Fr>I#1C3A#E}DuZ``$uW?>)&TJ`GfV?5ZI8mcESBiYf1}_6B
z_%E?@-lY>*D~^>D2+JFz(4F~qFkH3`sRzTSzmY|QUeFBn%4%6Il_d{N?}5mDA$ZTX
zdb_=5-#h}_tO^{pS07_5BQ#Xcw{5Ch#L^<-+8!{^BrJV*r=4_o3cM2}<vkXQNo?x>
zQkPnBcR}b9#5h}7!1Y{!th*UGyN}5>T5K%Tk!w;iePW>sJ;c8%7!`tlws_6vE|hZX
z#FfdTGI7-O)I5u{yXvcm?y3VX)x!2(({;-&1R0U_fbX#o_Vh8SPuxX(mep=7x%RBb
z99&Ec-YYG0ify*s+6XbXnN&L+vD$oYrf~^tE)Z_SXyP=S;i?E$kW|wC=}LdDR*9;G
z^po3ymXc&gD3!VqVTZer522*;MJhv&!FBs^2QF+zmZKPs6E|>L7u!a8IY;gWmml*t
z0Aut85KAXk2v;aqrk&fjv9SWirN&h4SwKXkZb)I(>XSEPxyfg-c@b3dkdCe@dQr9>
z9n%Y#9V~0M_`aomi(mfA-Pi|5ltssda$(-*K|Im`7@(@~sLG75aj;Hl3)Z^nsVFV4
z-a`2ZJC?4uQ(twTAoJt^W4I)K`*pRSqGQUT^pyewuttQ}xiZK8D{9VVqLitcF-(=$
zdRLT0X!<lOTmRThvdrUAR~F{%p$4opb7`KnnuG4nT*0N2qCnQTLR&{*e2toh;{xwH
zb3}UWw`HzJo_jGh7mb&vxp_Mqqh3d{xet`O=6`H>h!dEhWZSwgFLrf=c9RPiZkg-O
zR00_qbteDvEBYN@kNz_APowu=$mlt@Fq)b-sNvN$C0LUvw5YcLT=Jt(F0=qC{oY92
zVXS%Ju>}{jtV^5Azz%%l{u6dzkK0eGtn&n7g89OU43W5ypbh6d-u6xMfyoj*rTsGm
z_1vgOzt;M$m8Dt|QBxpc25`7EN*8Qfp#VL|$e{J8e^D6tGri>BjaHG$kB<M$l+{-|
zn^FUx=#?HK0f^VvC9k#E)!UvKNKi_i0saNJm}BKa?T-k=@>RwtF%d4Tw7Fll(dapt
zqBO7B%chrHqmA-@oX4ZbV>`}{3X<yG^TM16%{dOrh=4pi_JEm0i&TF}xJr*x99a_@
zZa^C531tssxPG2ZtEg5#GU}ZW#e$Jqw10S%omyzi7f=M~-m!7{!ZScF4hAYpe8uE#
z>ZIiL3l#&?=jPvObyLqr;LptJd}}$^iOQp^TD^G<#<lJ<=`50Oq%Jv$3|q3sMNlUM
zs$#{5<XC5adY$REquXmNZ>rE7Z<59#kEuRj4)ceOOA@GB-m7Wso6C+d6T%b+Be&g;
z5H-@b3Z>^6uI4Be;k)Ix>!r<(vmuI8kI;^xHZ#(KnVUNrk~AbwL!x`&y?!3?t2A?!
ztjAEAmz-F?Bb_KZ#tUy&${L1Tf7g}iwpmsrsC5Gym}kLEHm##3n{S&tjMo5#>X)J+
zx8LEs{K3Q$q@wXXqIt&%*uMIVTOg$T7E(p<exg&*3k?yE9B`rIb8v6F@-ZqV9Fp?v
z;efQNQ_c^w3;Fm*HZz(Z>qi4^{4OUx=;f$3mH>bwq&%b@*iOI9#p1lD%|s=AD_l=$
z+}nwFC7!$`YP=Y)<E`*$!RL9&l%8<d6Wa5uU&jl~ji(h!TK+M<l=s@jjih`_A6~TU
zt^QcHaFknXH>KzcWxVUBpGI9WBFoszOOm^f<Al>dH9bS3o77>!KC8^xa>+N1yqmSl
z@XY=oO@i<{K~L9ms^h5C^gw-ITDTOBx1A-|mNUQFeM%5~=E&n-p!Xjk9CG59*?(Hm
z|3X$&sO;EO3E^A<VLDU6yjzH=0DTi56yzR@R!%XJn2Q7bjZEU-X9HpXlLlGxDEcan
z-XWdtz+uW2LyHTIw=WgB$(Mmv8ELfa^k~7hsKNcicuh@h#U9_DzbH>AMW=WL*#jKo
zX05Ba6)j@v>C2ylb<o%Fmh1K^>9Z{8O^mdcVudRSW)>f>A3Ha-U%BP>5r6n5z{k(r
zNP=dG%l8Aoae|Jus3@{Ecu-O9@L}HAZCqSct{vg==DAn*z_O2HARYW%aSFmh)m{d#
z_>Z2_?T@A4m)8$(YPasmS0w{2kBuRlr1hAb);D;a{pC`*r5{s_2c^Xq#7>8i=RQ*Q
zVTW7iOe)+%U7i6rd4<J^cHKIgm^A}sjPiAr9LAVcQN1?4SqdM_Tv_CDMbp5Ob2Zh@
zem3rV)^RbA^KY&c)rHt(hB6z4XSSRdQW!j5N0fwXVB81tZ^+l9cQ5R?e7O*f?)Rj?
z>j%AYcJ}xt70vQ%c>lZsF?)^{Ncqw%RZQHh?sL(^4l)jWK{M*O?Wu+EF}(YVLpRXj
zYOlP&AvJUMqQ2x8a`JLV^;@f&Y_m$))e8SFYPQ&7G0|H6UKUnVm6Q6s2T%AsCJuc*
z;m#2xlQhx}K2SAjxlFJNC6qi*ayU}UYplNIsCVrC6W?VhCFij+Pkb-<c-ibsZdlMq
zszR_6fn{T@uI}d)bd<mWnu>S^k*L+oH`sEsQ@}Pn{nCwTTgVGXRiR-owoKS{UWLsw
zmw(f*EJ3XrgI1tqYdOhq+oX%0#jrOE5Ull$H_DEPeBij{m+`qe-bT(r26+^m`nz-@
z{!RDd>@Rcwv}pf@ESgJ8e-Rd)nT|;0nz01-8JBT_vNCG4-^HVL6<GtZfUGat*S0B>
zM#7ISS%0H2w18c|&z|U{<T<cCdXD)2xx@M5DGuPT0FCMsG1n>&rw|{@_zK=iIZ$90
z9`sUhe&eY#eed9qW`m}_u7U&|?wA~<51Tn_g7LBuy^f*#vnjj$=J!7J@`S>JnyQ-E
z@Dm-Wg8F5>KCWlK+Kt`bcJa+0#OPyeCS@bK-DZ_<95#V-yOQ;1_I}<PEaS%Dfh3zS
zD0v`9uK@jW8lCRGQ?B@+{m@g6K<^Es-y3=ge87DwPZNKyO_^`Y@RO6z@eHKd=`iaO
zj%8le5`y>QQ7pV{Oss>w<XyH7Fs9C?!PK@JY+QeRwfhreUTeQ@HP6sP_e~o7=CO13
zLs~9hRH~c6%_~FE%qdaqFHXu9yH~goG=*}PQRdZ%X9W5CTp_|F#RFoOXZgsi>`rq=
zp;xYbNpSjVlSnd<a$KDgVg=L6AeewGq>)pw^io~wBdZ$e!wj8NM`_Z&TRwBj*!rk3
zcs+~e3h%-7ns(4HNu;A;V{1;D;L5Q1<8Spehl!G9wesI)wLOTDEpEbl?aR1@iYR5u
z9i<c4bh#iEd#eYs6vf$E6g!OL0q?SEd8r-#ej+<v5YP`iIiFXOiy@|Ys|!aQ0WXZ;
z5)o!;l3nI5g+9D`99j$|C;H_Zu+8dYWx!n6;2X2aK)20;)7&M~Qm-y-FxNk2y|@w=
zn6;yM@@qNL6r}plW7IBal1Y~0z`5M1=H+$o5}6Ku9&qN=r`4AE_&JJV_=Az=R{hV+
zrFD{x?}0q){PPvFvmVkUv5;6i;(_LSZmAG9U(I_PRNpAJcCu-(8Ygti#K*b6qGfYh
z{)Fb9i(R#7-3~@khmleL-fa+$U!MKbg8mn>ph9KDX~tX(rlpckip76tuKTy*MaTHu
zEUeXehDM9XT1$>Da2!9?-uWWMXnh7T;O$^*3}Qwb=C!aB-CajBM!U%;R6=wiRGIIC
zhO@~dM)If*PMM*jB>Cg!%HP*YKUt6EiMJ1VXE<M~Q;Ay~m%FwTZpS~!^mKM9rYdsZ
zxYxP8?J#O!LAz(<=>S#S)zirlbOUXVb;ad?!r$7R;oQ!Md8`5P#?-ZEnuB@0ns3l_
z83fA7qz!gGbU=ABdvVYikfFyaEs?F?F4Q4^RI=XZm{p8~g;krpm6n4$SEPUD<@}Vv
z)w^}9%*v3#L2C9M`*sl?<ve(E)UNG^4E)7e?fJo@@hjxs0=Ou}MR%Pvu^2-sMHakt
zDAdN8pW5v;){|UEnZ~NE<O%DAEzb?X3`hLg#`Qf*&du+PGndxL$!4qRR@e>HmUT<c
zdcwlkTnxZ8->M=1&ZK<SX`WkL^T=NLV2#%58eJ|8@cm3XQBu+&?MoQm<=Q9Qe4N*2
z8QE0or)SVjTHoObh~2i%EGHD13GTQtaN~AQpjZs$Zp6FlP<w0t0luj)yy->0Cqqk(
z)<tRgVw89NypF3?{!R(^#c>?^6N+X-fKhwTP>oTIJYsi+=qBty=Owc7_GsHTa?=OA
zhg_-XL}(^RbG0+4p9j3uoNL?uZCR?t)+IkxsE@crlOOV05u~=yI5XKAKe#_~tQT(~
zq;f}NeOAz~pDFJ{DB)4?WFK4~(dco~2X*oROGl;3hy1hZ4R$Y+iwGa7r!6*CYtb?*
zugryz{D13L_IJL|^vgu0y;1eOnW2D)GHx3po4h#CQ#luP6C#s!{0%UT$?HYtOhe<1
z0sYx?H}xGHUNgsSsNP6Bjw3YYgyGvw3AV|M9cTJD*l#zT!dAC1<_K^LciWJT*u;Tp
z3Tzilehf6uk<!G(AXWs<#$cnw-5FF*&4hZz?~4ilC&vCCzn}jWSC9H>j8BO<_TS_T
zzgr%Hu(URk&{-GV7W?VSBr|_;8$#)aEWUyF)=o{1kN-k63(X-k&WMWn(q&N~vPTs-
zqqTMsJ4$T~cYX|BNv4_SyNS<rI>^0ba@p?CJ`A*n3_Gye-hDfF`;v5+PN~wR49`Ug
zMT#U-uA|Pt$v0rOw~k%ZbguM_Dkc+C^Zdar+vszdMm4bQ5|X7)c7*mjLr*R4Q`odI
zlCZ4wb#SSeST)m_`9&4n8*pB|>X4kO6qZ6H%yvi|Q+CO@I)&49bGxCMA(xNHb(%T}
zhvP>r<t_Ah@jWAZuf9%HhTZk7R`EU@?vHKMjJuCijV?SkbvN6}w^Cg$9>I0*Ih4{4
zQDZOZImXilRG=HjuYf*emE5Gpu~86>no(xHLM-tPbfa{xw#DLv*hyvQvC~S0@VB<E
z-oBf3{T2iK@iOtp5=T_l5c{9VSBthodc>PR?Kwpms$IhCvrF(E%V)V}?V6rd&ME8S
zI>uobpMLCE4(jo7TYE;JL`f%>QZ#YmvcQ&rlGVGe3y^lX2E4U`&wvMEvaDbv*-a8<
zD<ANMGPA}PaAvK%EK=3gO(kpNB)-5>bR83Xr+4rR@Y0XHnlLwnWBC48RJL`>=Tciu
zGe6O)1Y`dN50WU|?5#xONuU7id`lZ^s<ub>TbJnsYgPCVxA37w^|@%fz2>qyFV5o+
zU6aYZkwmftsq%Dty-sF;)UG)Se3LYn<5P5+hR7Tfvy40rsz{f0=`5LYLaFRL+2zu5
zcB-wD=F-5hf&YNt=Gk8+E8)*UIFnsy*%1q%+8!Y$iHQ`pR0r5BG&mBKICp!K%e(I0
zOH>5kdRKpJ2ocYv#GRw%?T(6|=OqattQp)<RRw?n?qhGw#2*Ra_)X`wT?W}(5#r>R
zm6k!(@NFePX&zwbNyd{ROC!Nup<p0Th)MAk?3FE7e_54uCNJP@NM#6_--0m<GMDjJ
z?UvDCcNwRq(imRz$Xlxi{>)Z?z<=O(voOEYwf!Y|osmLt7T9C28B=B)*y<-q)Le${
z6LwUL!qC~C_<eW0ow~Czq^o3(WKB4-<MhI@{SsGbFF?yH7I~GT6$*M!@DyG-`T$^`
zeB4;5Lf19lG2oina{%-;(16IqrCuF6zZnUC6a%l)cQOvE9C-{ZifzBC{MP(QujGVg
zwB#K;ZGieYE^#w)fXsT?jSrPYQwZq$1%L~?yO`r#nc9hj7mSoRrfeASlb#WT3QIEc
z_26^A0A$yIZdC`OdMC;qm6lHWDAGwLcDCnQrOQVp%SXb$UFamjp1rG@>+L?ISgXV&
zNqr2vsd0nRuIj`^wpB+68u5^+ZYGJzVvNJbeEWk!L5Ct)NX(7Q*~2B$1ifV4JQJ+@
zOt56?UI$^%HD4kz)IQJ07TbnaTG&At&Ye)I^>Jx7JeI0Utsg0C`e2T2hTm^)4=4Fd
z7<HeDy;Ai_i?q6G+>&YTdZP`B?8E7JZ~{?U>>MlQLwy9rV&j8jHX1OPd?0cKzQh3m
zyP7KTEl)joT#;8Ww;f-pTl;hQy#esZlBXvDN~s<@@`-{~m${bL6c#rFv-yBWr^!LW
zqUKec2G3hySDM-}8R)E0XCKK{aCE$h)?1g%zK=io4**Lhbwzt|eeB)%{1J-81_UpE
zz~Af3sn-s{xo4hTt$)^TAkgTb>osPJ#T;{jh^>92*8?7(SC--A(+mg|V2E~#oiegm
z)ZNT}bOlA`7a`ol>7(UElnth34$Y08g_r(R@hZ|X5xqz9xkU?hDM@u@zN;`0bEW0=
z%DvXvG|$KTV0k)g1dy9YyyCn`c>A=($vTMCNLRu9l;rhmwL4yjth`M+Ld$0&ZIfMB
zv4z8G{JarFremoOtiS{kbo)MuSXztHew}SADoX`ke^vWA@L`01GevSL=B-NwhT|wk
zCkI-a<6kwcY!Aipv0(~M_u0pi{9Wv}O(pBw>pGm2pO8=Togu*TM}9KkbzYoQbM~#k
zu|!fh8a*lYb9c=*+6Mz2_FOwQ9+N#Q255@=PT^r}_AJ~5e*MEX0zv1fQ&maD5z<_+
z0vV4naQe?WZ0BGHmL7|@-aUcwTz2p!0_z<$L!eX>0cOGHxat*<FyySNee{q>?jlKB
z;{}R4kDD|=@-6xT(Xs!O@rjH{`Xks)Cm7gAJ7gj$NU6*}e<_P*(Qy+neW%63M)X)I
zy-<km_@`jq(cN*<h%+9>#?a?;|I-Hh--kB&ttgehZyjt4fm*T-(bc|M8r+3*W3%v;
zmYO|tc+GG48PI}g#ks9?Po%X@Kc0j`bI5bmFmPw`rR4l%*Tswk4!kggm7P*#NDnro
zJFB^J1Qs6Guwmuz?a-wh>W+$OJ9F2H=xV<d+Gs>gnUsF~1wdEdF^_8!)a;O@HlkSk
zH!J*nb+>HE**APu!e&%;N*>_i75*SP+8@yw{H^B{3T6n5QAHTg_1_*TVCo5Jd8*S8
zObMgx%hwmDXZ=t}V5+X~u_VOt>bdg<H)1HN*Ja*lAUtz*8r0;%+x-aRImSx!PXW_j
zmvU5l4ji<OebLpPQd+Q8Ti`!?(y&D+LDX*64U=cq(zN?>wbqSox!(Q?rnb*XHm>ZJ
zv=_v4{a6A!euM}k1{*KdC40hf;eztu?FBiZwsRRSoveW2?)uNe8Mj9z*AU8jN|L0>
zrVF=Dk|K0MDDmpU;`b-|gQOf#2l+$jXr3weP+N6{W@gJ}9NSaB5TL;Xui)THoz<%$
za|vbL+J?v75N#cr?0ZbF!O!hKEDlpD@09B&dk1>CujH%b9A@1oxHxMJh*I`BL%+40
zga{VS*nWiHzk5qewrQZBy^O$Ja`Q@7UuAoY(1Alyc|<zQhyrNTCta$)v95G^wy%+>
zr5OE@=0*pmq?bFfS9Hr3smsK?HM46{x7)mTe5go1+x7xs)!c{@O|7fyGsN*-o{h;-
zc+#UmXb)CIl3*uwYZ0lzcpQp|khgJ*#f&N+3w_0bbkv@LwIdy&EY(iA)tt(Ft4~$3
z)G-G5C39(A*}5f_(%5!n{7TFENya6c%XoC8Kf##NzhV&E_~E5q<=~U-qz_Hs!4-pz
zmNy}?KR*R(E@@}Pg(4+FMdT+og~6=u0oci=9<<6#qha4b-KNZTp!*DuPAT|geu6Lu
zsli)yP<uJvDD%SYL5Qr;jVR9>Vs+2rUFy0>?Qe`s0LDN;HspRfYILwXCQv*qw;d*9
z3-R+ra>Zjosc+0G%H&GKI}mj51A=aky_f`3t@mry*4szi)t`fQhnU1_!~OGxG(q=t
zylBo84MqY}mh$a~M=#2!Tr<^twk?Ov)x}6u4jARnK&-M55vnk{?Cr#UB1Sf)lZ8Zp
z-tUHmB9Bxd;%4=$4|oe^I=vu>po!x(r0ikoK;P;M_j!fYG-Y!Zm<8FqVSsFRC%c!L
z0&Y*`*j1pL*}FmM?#K(fq-vb5!;0T1(qP%+nvX2`3Ak^GkHgeyjim2R8uJw6R+R_b
z)1@dhtrzA$m03rrq<0^d5K@^4whMLGwa`9L6=$Icm#`xn17S>X%5DWWGiI987{iNx
zf6<7e48W-sL&lZW;2Y|a+(+PX77qqqUiv>l{e$^(B)5|4RO@-?C*GyJ;h(N~{77#R
z#Ab+%ba>))kZ-8`qj`ZflSVuXu%W9$fd9F%WZlZplh*Q)0DW{|iF6QQj57W2P@MV8
z;>kba-od>O=(kibhO_7CA8VAu+Zu(Kl%{ngZGQTS?t;p-6$a^Y%+Xd(jU1&pK5yRq
zSS9cOd;{L=<CZY#H%&?oLa(m{YuIO;?97UG7y3*I^i3BDdC){XJxXX`DP`1usmJg0
z4^&BJ2b7f@V|U8bLzOjReMe;M5q7O@7PgzU2g|cdx@ZTgcqG$H`1>1@r()Yc>^h^G
z9GFOla8&T1i~3O@kB@tGF`hu@FI&<I-9oQr!=9Kf5_cai{h-+&w?!dTNs*aJ{I|8x
z7o7wX-`b=bJbEriis&GQeWze&aCu9_c<g7R7*jdYpo^ncwifo@2#-e=P{qgk!4o%@
zUOzW)#n{<z9hFf7JLr8bVL1rG2{>vky0(w*UZ1^OB=5rYnov4~)(F}n(4w8LnOlo<
zM^E`0UW8JAxFNnzC<7J1*N}F{;0gc+Q!7yWO<C?#<GIPgo%c@OVn~-getE!Th~m6!
z3k*f|o?T#43U#>|89TiROgk!+-oae9f8ne;buc6nfbSaWnQoUgQ@Ca~^I9JzAm}<r
zb`PDRr%eQ9pE_xnw<aeAqG;H@x3VcF={yg2bW>6$RdSbPgFSbq$lwi~0p?IEwlgJc
zffcFumi=hb4rfqFo^e$l*!0+XvvLV^0D?eJx)6C8-HIMpYzlCkAv*L})?t`tNW^)8
z{naML0?!^niz!k@@96yeqMmq4&-ywSqq@E#sv(V;Z+B2Pu2u+2?c6rrI2+p<7etOJ
z|H@*|s;UqYd6|DXgdKdVAZh&*_2B2>UdJ7mVT@aZxw?k*PU5*E(zTFep<BHHqF>ZF
zX|i;!VzULQ7HnvjDEYn&EDYBud2f{Wn6RPZ{^Nl<p0_LYFTJXr+7V4jI({9)>!{rj
zc95Kdvo9S8Q-}Hchx)p<I1#NI_`_YpD&C!BZVpnHuV2*ea1@m{vSuVG-G?zWT>rRD
zChzOlk`6;QgDLDrH`8Z{!5*Sx;h11A6w!o>WQ5kT18>?E@l`R~s@C&Dm!p9dM9!O|
z4q8`>ew<IpSq@u#6WCgzQSwYL^v6BI7AaIaM*oD>aL$nr&grC?e8mww$k`*Ms;umH
zHmi(z(2Vxph8VQWKb&E@ZMH){*800oFly{alqyNT8a6j^z@KX%o4<zJw>YNa1PN{@
ztgQa80v-Q|f%q+J!9Ty)+ifwqJIavEdF%K^TnS+gH2IHKX8C`4J^!Yp!~9#Z)^{Yc
zj&YbKfEWmh!BY+1qP~<(ONlzgmY|4_KF8o;5A!3gl4O#soQ|g-k->SRrC*Y^y;?KJ
zPBG|$M43zrV2wPH4wa9n3&aUs@Y)vvo*7pmcrJBU@Mad@)E<ymbflRNH6H8Z|9O-^
zjk}v24GG)1=6)4lWU|IRSQDyk=_5mU85iE!aK1HU)`T19Xe_sf**$k$r*4pn(Zc2T
zIF39zWz`-porQZj<)VYS8;ag#SAgh0PurOA>hhzVH|=CRM&l^W5YYBmC14uAe!fS=
z&{G-4`$S!wN^7E~iltt(n$pl&eht)*AMv&;_kq4Qiv|zj*Xmu{GzM$EQie8=1e~)|
z`!I%SXy%!9{xTTWoO$fQVwGiuC~}|<zq=9WeF{sQO=B)0I=Y=<SBOPNZ+zd3^-Z{>
zT0cJ74|E$8y#~f?p}E}GN$j~g1BYRk=R&d~im&=>-2|6?rWOow3;M&44~-Rz*4B#O
zU4{#^)=~uF9C#Z+pCvPo0y&{)w{mz5r#8q#>RV`^UjSHtuo6yJTOboxwOYT#M*J|7
zhLe}|)avL&6}Me^LMK6ocKU@>@azDZd%gF%FKW-s`CzKvvI(*b19zRT_)rO{@btN(
zYE<Sf1#VhVE)htdZ2~%JYv~lpoK-bKNzqf*bH|0Y%@#5R?&3!ux~cc#*&Q@(6+Lfd
z@+ozS+l)2-08e&T3sAmK65J#mgVb?EDG<+3Cn89gOIz05wQN~<d(ZOA>6SJ(1Ju~y
zK@+o456^YWuE)+6Zdw{{)uox<?u&ubrb$g;PCh;yqIu#YrBg<+fA9;w7~XiLzvaB1
zn<U1yOeHGZWyrTNzP3#O$PrQ%)<ovtY+N_vE<qLKq|BFG63QD6RRuj|a$=3sz>cd5
zTkGv;zgSLh8XZOV5Nk*3x#ptswSzj?oCq*2rjof~KBZ%w8V!C$_G21OufjZeQK$N4
z8x{loE%XV=0$%c(TEYERl!LbCvD1)(z4z@)^HXV{-ecvL0KWh@YyFTi1Mi)DjVKf_
zzb?=w&ls3{w5XlpG`g<F5&MRxF@CTi9AOyBY#4&i6@-Cwb+wU2V%I*9XN7(%RsXN8
zyUu{=+F`iDaP*9+_?)7=bVrq1_9K)}I_yv(zO|$Q33((bLOBksS~j&K+Fe$VnzR=`
zRoE;oPec@U*Uke%lte%tuVJFhx5n(PoL5~Oyb{h#|6E(R{&9?r1uGyw)G_eZ)FvIq
zVO2cf7Wk$1MmzL%T`%*!_jHRbTT3GBNKK)1U-%0ls{aGa_XOsrW_vezGuf=3g=8B6
zOV<LLz9MnjTIOmMXaFJE#SxjmN<pPfCB<E0j1>RPcIda-ufMkL&z=JHXTNbOw1QDR
zLrMS6zLnuT|I=g!zgKkstMlH9SYTP&F=!{di?yDXoZ|`8_gjaK;^d=cojmP<D)dnt
zP}(h?MDAq>k;XeIL_~*|;yb%{Z}eLc3*7hJ&!tXP_^%6!7~7_M-;g9-S(<s33C=TH
zxOM3gG^k#~ZrabceewIYYq4(4q61R)UMYv5BIj{)bjl{=6bBRK<`lgK6WtU|A!4nS
z#;x2cUz^fiwZqiP+^2Vet~pO3(Qu;0hF+L5<a2=nKF@r_xoyw}d=0`{@Q!I1V0)o?
zQ_D8LoM7VYJz=fX)2s(rj(3&6(*C*rb*JhR9%N<bwbLIzRbOUt0-xnE=ae&BDj?^t
zo?I8J<);R7)K=KNk*kzzFNLj>YBR@P;h$D^Zou#YtdwpdVN^mhM%HT|DZVuPlqDCL
zb9wqz`q)x9!7KyXO_@G=3qn<;m<sQbo88z&$=G??(XWrOX&PzLTq8qu13MV4_F%GY
z3#WoYn$#z^R@~H#k#9*9yK}~(R!4OC=JHY<y9Rm`znW?@Nf0UY!M{m2enCpJ4W-w_
zmabnptgmS3o1bl;=e&l?xE7uy)O&8*-0?kHm0824OMc(3*cmOWQ-UhnvuYHRpb2>8
zz>_2;3HQF(Z38>G?x{SJBoze`Zvrc|8cUnvry<&zQ~YwP<jxjnxn*8MZKJr%mZKik
zb*{sCANnCG2>qaTbi7T@CiDk#us%avG4rLy(@?Wqkc4sl6ry8P3B3(k=?PoTs~u-A
zCDgT-uEsr5^Oq(fK{}2Zgg8%<OZG-|U1Sd4JTWS^SlvHG<kIV0*hv=dKKyoHU3ZOC
za;FzBL?N#{$2uhH%0iv-sRJ*X#;quzK8FY3b3NVyQ2~+*YiGU_6eRm_ivw7%LnIwV
zSZCYjpC5XDc!|CFqN>MDHW6T#OKb{Mv~Grr|4M@>&ni8$>}Eo}#twQXsd3)|d;f*D
z4IJnZZV1cVio>S&YWt~^T=ipqGI$$A44t~Av~oi!seyeLB(8{2;p25n55vg|$+K&a
zB67n^7~+-s^VOpE_wo5pBq#l{phyLtj^>WsN_P~mSW1xoGdKgz^lY*#y}VBeB<5u1
zSvy^r6QfI>{goX@{!NX~zoJpV!9YO&+U<SAq(7nURKrLjZK#>~VA&u^Btzd%Vw7zV
zsItv+rG<}Ix}9u-yGe?ihD{ssS)SM5d2eUAV#py|x#+*>&+HK{%^F)W@k~(X3=c}r
zR>BsbH+seE1w?jvK<fpB@7F~~?A93b0e?N3sYUi9c}IJLp%u0LJM}1km*Dx)>7Ost
z9H<A^`#WbI^br^i)*<1qd5Hf8`~Ol?<{$M{V&lN3N89&ivv2YoeGu@_${PjuueY0?
zYY9>n_fIOtab3n3>#{;F3A^$(?Q9W36>aK7+gd#*)7$FGZg%Bn<#7d83aSGQ?)k9J
zrRU5$^0QbfEeUwPoC|k@OXT)mIAH0H3hlM>Z1(l=4JOl7N}96mt;&`-Oda|!$p`K8
zfg2>NhpT!zK2hqe?hZRyYALSGH9MEA)(TYD6ddMnU37ZQF-KW~?_GK62T|?q&Sh)w
z^%=PU;wq0^e1M<H)<^t2>jD?e)&Wm+x&TriUyKzOvlr^hR^vK&i=^W@bytfd&xiBh
zu6tvxf`tRs&5ffpn|VSptf5Qk8nsq^uOmT*2x>-Ks-L6tOu-&K+>bE>#o^lfjS5|@
z{F9sY3pnx9(%P!du+jr7(Q-V|Q-w)eD7}>$0^0|n$b<Y&{n!UMsrmV@v$Bc<*M_q`
zRf#hOGU@1t;P`dcx*%FS=?+U~v?#d(QRkm;vd)GF959jYp^@3TRi}s~-J(d9r~Zxn
zL%4l<%+pIi{h$seAZ+cs2hAZ>HY-GhT=#%ZuwxH*qIHV5m^z93S{d!kpy_Qs(ll({
zF=%DMlUSmACa<+vuSH0t+IFT`ns>a7*{y(wg1o-v-VzoN&zO=uQYLixz}AeTuQ!v|
zSlb95?o^-_U6u1fE>wTgJ7F_A!`3;235xZs8@G}QWr^4<cH$=d@Z2yrZL-@z#*|(h
z)0?!;=Ub1_*pH$4&mL!CN}of<Vdx&7_jp@!f2tReP&zUT$UfFKN7@^d8N{Pnq&G5f
zb$8CFnsR{#sd|ES@M74`eEsK6A1Es+^=RRer;wi*Id$!aESpb%g!fR6zfNyvWUgcO
zZUAS6KD*F9WnQsyin;y>vKP<EDPgO}p()oMVWeqPYt~5jiQ>9a5NZ{+0I|9ZeYt_t
z7Ex?XhAzeE&n3d+yh-D6EMm3XR~F>rkzs8!w;N7CGwV4#4FkpRidyO+BX@GeR&zXa
zyzb<LqgN5HJ!``0AHbq~TlZi`$X{4Lp6a*~5?xQNLpUTuX&@i?OhJR^wmp5YRbz^3
z0v!3QD?f!Ia~cf-frwvA<-f1FfA*(hytsULca51HFXStibEmi`kyHLt1p)N$V|4w_
zsNla7uL(dOK3aQ@zj2}XhrwL+uC_x30n9)h{r6RK{7aR_f3RiDVb%D#h-*hXHAs1%
z11Ljx*Myg;VbuCM&w)MXzMbuIn+9PP11?zQJ2W-+;WR2?E@-!P@7ZFUP1?{Nikz`%
z((R4@cB<X{NYNp1WuDo&?UhxC2e_u%LcOP+lUxT*LR<PPHL=8X0Bvt)_=83CFw|nq
zflgzu(XhJJ5;GA2k2}6VRnXx%YBdtLo@jkLuOj0}aTuDDV+>cZ-W>unzp%f0TYu)Y
zc0GEMm3IKMg}scD0xP|9=3UPOtr~>@HZ#oLA@UmY8ltH>fgTK+Y^`r5EH{j1WxPbN
z;cwHDzi9w!ELDaymx$BbB)qsTJ7o9XkprF+rFvhgd!AH#gyOR|73cfuLA_lCMojUh
zgM@$0g5`+<At{_U0e0oC6{|1&&LhAVT11BDg@U^Kh+RHcB9;q%D{+yYLeg5lo!Twb
z{c_JH@6`a=^q_GGwH6v^^&Kqt1*EWiAAKd)CD08$tl>74co8q<8=j+E%e0z+?<j<d
z>tyO8oo2j0)!#tU1?H-bg46l%Yhga#{#I{pG8cffNMpMCr7hRae)0lV!qhzUC$Cd;
zY2HOuXc_1xePB5Z_rppc2Mi;7C^w%~Y@t2e0$RUo(mGD2tG@Doyo@Jos@w%?tfLhR
zL5DF_$Kc<gRTCvQH3S-rHft><2EJt>ovOYi8sM4c>cp1eWzyjeIZ;3wt3Jw-4ma*q
z#4!;~B#L<L;3vQzt8!EtoF2eaZvf^j148mT1@`PYw7(~0-(XRs=cP}z55|GP4Lu)g
zEcF9*c&3d9Ry%fGQ(2UdL|2XLRN(E6B0jbY7=bd57Oc2@aK7mAE&Z22E9p|EEYFmR
z5F~T>FbkI<j&C;+gv1@eFH}uU%0<P>!Ul{vGg0h$uakVZ?di11P81QC_lnIDH!p0S
zvOW_wd_POYo76hD#yW#(d?_-<E6h9W{C!?N94)M=#+q2|2DXniYNseD3te;y^K6#M
zaFC3mrInm{haAI~H~UITB2#QDn&atn+*jAIrymCLZtM;~iZSvG!}8~01;106dX|AU
zw`SmeC%(J^?IkAKTuZ2NGAi>e(gZUwhM;L3*NxgJaZ~w<%4Pp$2DlJx(3jB{_qR3+
zt4LS>!-(N3v3}5nlxym?IWUc)+uWNHo-3bgkO9M9xeRvYrAy_Z-;A*OG?Gl$V-m>>
zDuQP|@am6o`kGj|;W*t-tg=wWp`sy6Zp1*t`ee3<a{A<mu+k)!`}37>g6E;cfPvB`
zw@@v$=}=T6)bV<ySBvChuQP<M6U4E1h?7KOn@~6#0fkBZrlW_H+t)bo%ye&rrO)>5
zpHBAz%3ZyK>tn1JJFJAno^9SaY$RRW)nA!sd?vEu?xTgzC7$`$#!!E{2){`u3*x5a
zno!fB1mCjnucsj>QGRdk!T)c6`<HV;{!teiWYSy4UMByVL<J7_bQukh@4xHM1ab8|
zbSl<ao-OB5zlzVlpJc<0N&o4sDRcDQ+py6N_NvS`{W&eS#dzk0_MQrua0~l%9`J37
zR*P^mpf>54D{;(t`0y#K4z`<a_lZi;gY0#xGkxf&z?ZXi@u3N`MVX-v+7bJ9Nz6AR
z&3y(Av*YdVWjeeL6C}6s((P(ElPir|eHIt5(vIZDV~-Sk#%=I1pp+@*M21pE`<1V=
zRq0ETY6B8RtJRvaA=E^dq}BTO2O_c+SRgPoD;n7G8W>9S&Kf<hsm$kbKzxh+JYAC~
zkjba4W#*ufumFh(dI`VZCsvDK%}VU1?!#F1m}s(QBU}39SL|%a1z?aug;%)bjHbk;
zSD0K$M3JypyVID^rG^ysOUw5Y-Fo|1UcSVT?|}G&f<rCK=PBP3)fFjX)nmX$EDgV}
z2YrdT(wbA5+oxnM?0%zx|JdQ|Pdf#C;R!fWw6Yiyx$Mnk>OEhleYsPdEaw?g35jml
zi(`leOFd2qN3|$AZp;s!<PfU1XTNhsbHEN-1LF?Gx^U?F7`~xu@T8L(IPfhZT*j16
zjVPHCw)Lo*US&3JLbC6Hg#XT567PgmUYpcyYX-zck`OPnM#^Uzl}2>%acPXl7D{p@
zZ<X*<z}i};RiNcUt0qr38JcU!`Uj4%_Lqc;80Spxd$pNN>odEV_X*T>t$kY`U02UF
zsrB%YZS~~ZABS1IqyFEsqGA)A#o67y)Rz=hSPJjB4DE!MpeJ1>3NYR8u}Yk8vBqz_
zl<*)Z&~2nX5;a!c4lKDI1**7cQZ6C<xu&eD+l!92R6B7(cGkRf!&Mri*f;f5R*Kik
zTIr=P)zxiKrY8}2tzk0~6w~zjM$J);cvXz6bcik`>vO`dWF_LcTRG-Vx$^JyNfVhT
zPpTpdy-v!9n`HE@dp`{p{c%8;aAxMIwqCEnMl)*Sp^cJH*ktSi*!?c5$H7^qS{oGh
zC)Q}5AcaAXxp=b1xu-1cvmJ`WOre+P6!%QTG*IYX(3MkG%r*%shjES6KL36U(8c4*
z$9jn#qP&Xb`YhQmAP0X;e(K6iC_@dMqWW7wbboE#2?mh=S6?IZegf?^SO3TuorU%C
z>Ir-*duuSzH)TU3L8D|Q4ay=~_CL6L@3<z{Y;8Dz6cJD$L8{Urp$JGQ0!j;nPDnxt
zpma$n3MgHr2udi@ODIx8NdhPsnur_3(7PcbA}YNIZV^Rvt6$u6=A8NF%=^yF8Rwii
z?;qjm&vTPso_nozt!rKDMyQ||B-voi^!&Qz+XpP`R={E~N4ZoO0VzbEi+=L>)p@*U
zu1218yi!(Wfk#!BYm5V>XKC8`<*>)Jo?Cvu1TTA<(9W?3NXARCw)gQ_Rv+sh!WV^U
z$Nk-c*wVb1U2KC&P?W$o8eFweYn(4ug=<pAYXj|Buaw!$)L4k5y(VAon2ipn!8FUf
z*$nybV6qFlu)F`$v*W)%pRta3g=(0pDnBI8eyD_g)oM}t_G+ClO|gBT4`OEO>7jvr
z=z59t+q7ia?n~W}Cj<aCse4q4`GG$b5vFO6EtS}_S*yU`X<R1hPmjIQCFUa}yKCZ@
z*iy}3Oe)l#zy#?=PaMeoe=w~1iQx)6JWG!mr%0S@(Y2vY@P93g&yK1iVvjB>+qhoq
zLRX6?+LX)Oyc<G&MVQ{f|28E~2LnUu0)3{a)yd${xaSEXp{3+Y`{f*zS9c}(T8<4D
z+GkBw$K&)YR@T%Ea9<ymvUf(^)3U2}dqR94#A1LePH;;mBcxhg@|TY1tFmk9Ca^tt
zk9JmbK%EC6WU-thYW@gV<rnv@Otp2p>}6H+VY=hVRj9!oo-ij*=O=J_<Hx$PkVy_O
zW*HsMhil?7LpcT=z2uVMY&4Q6UmGHRCwHOFh+maPPrF1xJX$JZ>6Rd4<g5@mW<%X_
zl2HYug;E(cV;I8me4wBONX3?kmvGKD6NST&{kqQYES94h9_$juL{?ZdOBkiO#!zrZ
zp7wUtE^w)cOIZ&o5Fyi{TpmQ0T?%tt&63dBa`}=dQJG~%H0NhSj4FcPq9079;BhIw
zYieNbk1_)Hv?gh;DQ=hQk|<RdM$g%`t2+U$=y#NPCCTedZG6|Rfc_^?hjlwb+9~u*
z{tW;-#+lADZP}G6C|^+yAIb|Kncr=?Rf3uVg=@|{;ZuSS8)K9`;vG!(aK^uY$#vtx
zy1-x*I)zgs40%@!hqtcS!6_9la17+;Y})pA_%F6d$~yXJn`wSs_NQ>L+=#{}3B<W}
zov;P3PZ4^>88&Li^4LdC2OqB1KMm3F4eMuZRF@hBUQf`Tjm8(+y4;(}d`!7m-7)H}
z*1zt!<Ul7+S@tij+v_Wj=IcOfXfl|Q>_rmI(%(leT!NZRG3ec1wu4H>X284{RUN@I
z-*)}(v<xZnuREt+dZ#^5M0z?J>i+2?#r4RuJL1C%FGv(=5mReBOsnb>Cg&gCfp$Lq
zCXuG*PEkXzLeF3ribH|Gl2DxPISGh0ijOl|RxwxBYn5;dI~I+8Ri*hcJ+eMWGem&C
zC8GIJvO~ITs6q__2$>~6>hKIuwPNq^a?2VAMG>VEb|q}gf+sEk`^Cf?=+g6kX<_&V
zjMIku$P1SGS?bR&C1v}AqA^$2XYNLGsOM+yTfmuTAdm|1It*q71HkYQjJhGeR~o9l
z3djNisVdR{Ff)i70uM+9dR5ba09x(jzYZK@#pC6|dMueL`bd(<!0D#9oj_nh#}<zC
zlIoXZ()nTDf;EfQ*;CL=#WkFj#fub^3ADvZl=y0kY~f%TLz0+ijOiOXNG>jB<b*{N
zDC$B<)R>`Fyo-uAdH{+Hi=NuPfKl#lZOuAzP?Of0)`6TrUm4xB=;*>ei^o~{(|wTN
z28B*d8;rzEGWWT}d+GT<*EIm2orU)45hxuuqP4ZdY)4exzsNe*m<NdQ<e($8NmXHd
z$$5ot&5X$#+<H%Drz8)KBIo9*oyCk)wGNz~^RrMJ?KhMA#bGqZx!x`j<_I1wx3#2!
zrSpQMAqRg9i(oUl31i+trAh;|Wt%;#={^+2{3jay=U$9z###Oo1+jl7T>1Ch>rWL@
z|6WY-&(B9?4Ncz8ud0lb#};KoqkK~~aI}_tZcTti5K(!{Yr(E?DwI{&C||0zV2Jx-
z6h-J8%GUVTn&OK?;w4in-s~4L7Yb8kOWLF<U&+u{VUBN>U4V-WvSN-gSd>3$ecj$d
zy5L1w7ilTB<{qEX;0o2BS2k#ImSR0ri^E^(6!+lveN?hdlhtVI(KUeVm=$XzHu!b)
zV><n}dp$Yv5r89tgE|y1pQLa;`rwU$0G+a3O^*5q{1n%~rjxu!JE}2U`*djCCV>%q
zW2HhmI?M8P^t6xEOKym3d={Fnk!cQ`6$@7#EUjsH*1BdEgO=N;FVR1yO7oUq43JOQ
z6AKxhGVN9Z8{k}%4B%w1gDX1X+#H#!OcnQJ;idDcr_j$-@-;<*VNUo3x2?2bpfe?>
zj{Pp~og8W*%j-b!RbI`3LK)304e-g%%TPZsz>u24nv<`&AkE22(m<-nk}0ERegY+Y
z(?T?INPC8{oh7jk8+>ROdCaTVe;q-^57SIf;gP<TQ{DZ9G&o8AFmB@9{nL4Q;Y5Lj
za@}Cp7}^-UR?8(oT4-ReK`t;JV+E_=x{y<rrxTA3o3Fja?jO#rOC<6N^9o~!+N>Fb
z^f<*WTmOjPKGh^B*^DfQP7GigA7_oq%y}o(9lCd!IHf9@LnU|VR%cv{gt{Jhaxn(g
zQ4xweo8xEFv~KHqbLN$3{oU>3P?#`lEFb;ONU9}mH8DbVN~Jk5XViJ1y1o&S7kN_{
z0BMALUGR;si%kk<L&8%u?l0<)GA_d4t@Xm9v8mLBVmYPUj#_|gJhJY<B1mH^jh??S
zsPYQsmNja<F99wK;NQX9X_(A5F0Ip(8XpHW+wz*IEX8`4OwIM?tUw)nXXj8_!xl#c
z?3vnJnWOR-k4oPYhTDcYJd$<Lh?&4It1?xltrJ-*^Iw@=<iIUIx^*wd1uSH!!k`fP
zViO6=bHA$FXGRlBJvOE>TO)=+BE(|vWmrrfLTLU&j$OFwb3zfO{HLT-{{%BT^9R-G
zA2ua}cr~G_MvI9zNd2E8mw&1Kzb6{%{*ZMzyJ+f|cHoAB2uR80o`4A-E=ezjZzYw*
z|C!Zujw-Etw_evA^py~Pk~Gr$sgBMe>??tKV%fgI>wGllu!-%LfIWMEI`<{?>&P2#
zC2ONTHcb0>vYp01w8@FFm!bxz!@4VA=d_xR-`{<5e(e<#`T`>y(}{`gP>}@0Z0V!N
zn#hshQ~2PiQ}~D@%-G=Q|0V{}-#gZy$vFDKI+}cPF7Wvk*tw1cYX)l*GEWD3(#`tQ
z+%uY$iOQI^>d^+LBi7#mF&`*dulmHg;OTjq`AIW1L97{=$_%HrSgC~uHRYMn6FH)x
zy}D$Fqu@YWno0Du<CVwPMKoW%euxInAolWmXs*%ReR&T^JZv(n<Q=<}D~t9c@VDrD
z^Y^TS<#uB{!XyVN^WnBYj~K_pv5Z{7Tk41#nAR`cPgUS)PWa)>5L&<-XCT*l6DDZI
z5?EN8pKPr@G{tE&@YXff=VS>XAlLEH)jW(>&s9wRGYjcqeVMnY2!OZ-&vbx4G2hVL
zcJ>)0Yw2UHkgv{Wn4D)x`s)C%(?@u`C^jcAO0Qv4m7DI2bnI2arQg7mv~~`zJ9(|B
zLQ;<`wOP}z1w=ly*HAiXj5eN%U6gL{^m0IX1802RdmqlAHhWZn{QEG?ZN;(;S>3g8
zX~ZauS1V-HN-JUF{&nC1lxgffvBm2pn6%_3KGmLkS@3NvwQ|(;4v_94?06feiZsK~
zj=^_Hu={N?X%5$CAAhF5J4RK3P2d+tOc4?=WyzX@gHSm-UJ!)#9hZIQIH^y&c8}^U
zLnsrln8jUdd7jl|r%98Eq`6{nQr62Fxug|~QK#D}T$J!@m+%7<_Xe!h>!+_L*uHu1
zRAazy+yx5|)WQ=z7Vupv?L8q3vT1S8>D-#_1X00mmH{ZDSs33W7#J%WCL26`TV*(~
zOuev&Y^z@s(e#Rek4tTX=0qME?l(en%@pSxbghHxhv}geZ-8*(94pNs-U6?m_08wO
zVe(gzPAh$pb>;{wl*S0+l)?yoT-r>Z&{75gOsProL7r^ebb^kV#^2>zw82&tG{QIz
zjG1FltvriRZN+;B?H`CwXE6ww<V)3|G7hWdWb4t2g2<hY`kuQxHs&E0-<PoMOkZ}e
zg}79n*ph&OH`Hf~1VY)Z-@T3}CNF!QFP$}D7HY2z0r@^$311AUA8gMgRH{A;JVh3;
zgQ7F<&b`>^@UXSP8lvg;ne+V$kgcp_^-*)D50dOpyy_e)fBroGyU_N3%=3MZ@QTF0
z2y*<RjFO*y{qMA&Y3|=SKvr}96)+&0>(6Tq)C~vL{43**$%ag(>y70wDl7BiipR5W
z8Fb>4@yZA0{kN$XOlB)8Q(3gUH4D@B>gvi5hJ)AqcfRt%ta1zw?~LPY(rpGmR5P7<
zK;Q*SYte{8`a^6v*E^WiN;F=Z#O#U)fdux&Aa0JTNmW+Ql%^kZeuHI3Sqk|vh~*Z5
zIZV$x8bN)+LUnjG^;4Mve~+vEkDU86-SmHR+gWM@pQQrh@q+fV?IK9KtX%PF7rsT)
zj$+PgOu=@dOGZxyEN~q`ysckyJ39Hs2#hCGXs*uYEU$EWy*gonU?&TR3v(F<`*GM7
z)egxIHKr{=60kn;mA8~zI&(7&*7O`N-5XTwy$IgHF9X|TSs&!gR%_)1JF$rcoIOH0
zh6+RZmYM6U!_xMjX$q(ZHH@lE2CJhN{LT@m-mHlB55PA{?nOPvvA8<-Uf%hZ=<^qs
z!)W$};_qw-Rh45hL!TW{*(bj)IyNZ0&umn4YCsm|da-*4SGx!L)8Z0AmM+zyDD*k%
z;E@4nbs&0CfMt+kyCUESxw#~sMKk@iQ#_vLN(e_bS7a<=pD9Svsct@}ICmzbYC7J_
z?(0o#3F{>p`)yZo+^Cdj92H(LJ<hCLkoDgS8B@}&y%?$aY3}aeCNkt1!5+k0@_{1Y
zsFQ;o!@Y5`kb0hh1(x1;pXGFbm?qlzGQ84!aA{grL5Uy(@S%Gq<J6ulYHD*((-0cU
zfleZxgga33P{;&#i^#qPRw84{sYSx{yh`@t$dw|w2iLbv($KWbd=W|<4>D6e?3Vh=
zmR|&&Dhr0ko-l695d)X#^3UkMQM1K~I<n2JZ*q`4q@FD#ZO8omWzaDc!OO1W;Qefu
z2j%UE`5M3p)@tV-UEnhgMt5E2q+~jL7$wVop`hA@bMLYvS<%5u_*n-p+SegHxdEQ+
zNO9|{?}a)E(flI^>w-&fDACU0d2h%rq4lOEVAdbOdbx<|7fHIKSkqfQxDiLi(3ViW
z6zBL1r9+}KQ_3$$n^KZ#$VCKI)L4D0K?bY`j26v0Jf@`OOAu0y7PLMpkVrEzOOZHu
z8PSpMkRPI^SS2|PJ)!Wq_Y?XtSRh{}9xb3yaa+?&27gl=>XQF@SubvZ5Z5$_v0=@E
zND$R)ACzZh;Ec=s*(4O5L1I9i8Jwkw{)8EXx)ia2_4R5F0=Ahzu5%aXHJM&+Q1aP7
zD2@u?)-u37enRuF)Lw*Ens&I6Li_;l-BzJvLx9Y9clM7J2NQ>HE>lWmn+7+qL@DN6
z_EX*ZGk;J6KX7Z}4`sdTcbN>L|1@L%`3(B6u>Hqsu<@T&4R%z%AT0Wce>vw{+&Ojf
zDMi+EC+UbTI|Kq@*==?IjOCdK1j0~Y%MPP|H(C^r2NVozmboG|uo2n~0M))9RM@R8
zs}(5VBu94jd%Nmm9@{_6fcroU;>$fleuM+_N-e&=Lgw23)!i~z`vaGdAGNFH8N1~i
zlU9iq|CFx9|J4}mXGl8yIq8i_FjR6``GOCy?6;fW`k1snOEB~%-@9~xQC57)c-dEH
zG&s1e^_UwL{n6DXzlgJi7qCgWX_+7#f_{{8G-Tc7sX7q}PK&K=!5Mch(om+mDu)WK
zT@NmC*R+Qk6JpFS2rv0CVyJcd@sUtR0lya%4&zc9sz_amqcD5?$ji1n7<|lawN+rf
zD(Y;j;VTkFT}g(2wn?%hPj)|AbT-3IJ!%u4|HiQcpzaZ1FcW{jHut!ClHuC&MfUTW
zqtd(d3=yCA@yNJnM(!J87^99Bp!I57i~b~`@i3;n;ot=a>M!Bcdf|G2fdiUHEoOSF
z(<w+!jN5j}NtyiR9?GTn?hJT}&yqlI#;X-KjaoM{t8t&-Yh2JFhsrY~9Y^j(dE=&y
zAUW@uHAWp(>V*<BBte-(rzQBFFT0LwdWS-eMY&nnldTLnVTwvnXM?kA<f2V)gA~)d
z*C?f+`kX)14nNhT4QQ%6PozS0De6bIsC0gFnLDgC=`OM&!0G;qP}A9xa57@ZG8cq%
zF-%(|44Xf{9X)lbS>%F_bfYGod=P33)hNlBwsdjvfy6jwpM<@a5hP4l2XQnb64UTg
zE+Cl$^uY|-(9DA%Ovw&sAfaWc&q=;Ux%EbGLPEBg?FY7_D6sITBTLHuIP_|{J4<26
z6one^iX}}B2!kA7bGI^U+oT7xm5FN<2F2p^VhP$fvL;z_<z7jPX!>NGcssc*aWASm
zBO+KG2`|G1t`mscNdYH;=*Kz;3zcHnZ!Q$XbM1nH`e*mEn<@kkEAty?K4t_)NC7K%
zaHAw;k>~gb4af#hr0`ppQYFmlNqJNlfwUZrw{CBmNSKkn^Jcypr)S6_Nq<f6K-U?m
zz#r>H(yZ?$(j8W6>^f}(z3!)JLBvv6wYyH+X$rR96V*+;kloOkq~nSZ&d)K}m=Vk6
z*s@|tvCrSM>VOYas!J1F#53P_wxDwl6`2zr$YB-c$oJaQBeH0xD_!}&X3rxNx&n$H
zq<EB8*(S8nb`QP}UZ3sQEP6Ppo+CW!Z1xq-oKIm%{~+z}Pha)pzbm3s0efqZQ$N6(
z!XFKW|5xxUL07MR+QU>htukA~Tqeb&1DRh<#h?Cb|E%>xIackTf1mv?VD$THm@|FU
zjj4hW2^tIrus(K@?(l7i4s^IHr1dCfp>(M)8j5Dd2N&KvTYGe?Y4AA*c`0KhS1;rG
z)IAYhYGHWYh`_Dany*9D*68n|)ZP-HtR3bOs40((^68!!h0DOVt>7;MyhlCkM?o=L
zTC4S!D&9P=lTJ;-108P^_`MJV-u8?8`t)}m)txIhkKbP)1QI2<G?~1pOX$P^9TA#Q
z+C^;54{yNZAEo^KE!Y3dbnlO!ISy+9%*m1*7k6}bX}LX6Xz{!Ya5>Co=`|t*;W~t|
zEAB$IceUo3D23`F>(3`3voD(CC}~Zh+7>%|buJ=@HJ{0%!$ytddc5B|hDLy;<V|CR
zwveu;G7ZU%5%ReE+nnH@S`lYCF@oUX`54hwGRO$wLY_MQ;Rf{TQJ&72j25DAn21^L
z?b^3|N?N9lIv9diY%jX>W)D;DHbJ!)D}GK-oDfyybe&|U9=47$z9&J}@Ncho)+pEi
z04?uyRO@z(n33<kHbt#+RAkvDb@e<h-{V^?W5+;l9Sa!)r~A#wmLO%$$+_H;&kW6r
zK5m&O>)m&dRE5r5rdjWpb9Dpd6=o_`s*6(C*ybBu6Ay3CQ(B(n^w7+FR(0!gIzqx#
z=7Pp>O&(QH_f@x7?;Y;9jyJ&4b#D?bAZY$~#+j04J-F+^xgSWxQo*HLEt)0;p4D+W
z<wIIq<my3P`I5vaqWGJDBRIN^;JXZ%xyFICEYw!<-lM!!hg1GdRD=?Qw=Z96Cv94c
za$V#`mvf``MeqLT%;&sBM)VLmk^2cg-1B`}%v9>#YS|%%&s*PMNYX3Ta9SXQ*^{mT
zLHFjDyoPjqF$fPT9}@K*v5@LS;9e<6Y>1p;h!#oFoI82UjDFEa5Ax9fqRG95=_*f!
zd+JiL1OeigNH!>Ne@-~fFPk2p{k5*_^|>TaP*O4_Nb<>YrlmSM@#L?SRl1HnBx_~(
zuM$c9xXOc#DNeCsS76>^77<4tEEGElgsXN}4IMzcRQp$N(wv>X=nIDo)Tj7rXfcVf
ziP(ZR{afwtF&X=}*hu6M5K5SWc)jU+;QWXK9+Z-*Ejvxy&)@_;PvYi)P^>2}ZMw90
zO~#TTrL~0Ai%^1lVZK6+qqJkcd}>lE8IQ{9A#>AQrK!R<7hkv(Ckb$M7I=s5f2<h{
zk^Z)2zKG8DyHy(<QZVWfVvkO}`8bW>Vi@@`gW4T}e5@@_sBjxui*0qAK0l<z393+&
z4#Sf!sdY~jRtq?bFd;JJ{NfwcE96{<AYt;;+4##}G`-n6$gU|$G8%e*SrO+!;+Yo0
z!+c6MSJ!Ih7Y9T((IFztS62P!nv17Qju8w1|H^Lepv%+*o%x@!7xuc<J>>@~3pmp3
zSrJx=X1oA7V7sQr#NV`$`|nJjAAkaS|2yFK0)yNCq6G$uvX?X;`rMw^oCP}{Vr0Xo
zJd35t7T=m4wp5=7u#Jq%m$$bvdpaw~kp=0#qL8o)k|NM^(o}2XNsD$wyFKflFS5*F
z0F|HULj2Lr{xc#0N69vV_m_%K)6wgf3OHD+>NL50Fac)T1J7_I9qunN)B6|`slhRb
zj!gPCXVG9kNEv6X61d`Bq=RXKmc(7%ptgm$?6~W`)**^7UwE_r=&h=DH2UZRf{=Qi
z*o|szRI@e`<?b{-%(GHP3$`5bHT=4v6ZCE3i|{L?OJVCk4^*H3g;@mq3P~*-w%&8|
z0J0n8_Y7s;&WDZ7&oe4cv~kMdzbj53eCg?YM{`F=X{!FYy85&>pu=ws7nvxvZ)QZs
z2ZU(BLS&PeEP|8>Z$@<?M~(<lVbJXr<9e$WSY3<p3e_g8hf5srVS>_dQ71haF$x&&
z)&^Z{OL0;tQ__NQFP*S_iVis@)~KYOnJ>v~B9`{c0%iF0gm#!cy!;r1&w`cU5#)9%
z7l2ky0-bqQ0$WjEpCzBM3{2&C6^&}ju7#eJQ+>rkV9b<z*k=}I^S%>JI21V%yn!>O
zUB$$DGd<oaGhL9qkWM|NL%?%I?v$UfSUWis&NbVm*wybDH0A?fOt2&?amXK(^u{!~
z#eVAN>~fMh*%U0xKNvq>PA48bETapRZ96Cy$FXRCHU~;kJ8P~}lWGQOT>v_!T~ypB
zt~7h=_%?V-vaKw%_#fh4E801QLI%g))sMF}<JQ7APiCI3tjZI-VqLdgxD4O4<uM1L
zlFgUUU1{DgU4{(Og9A<D%($n)hJ0ZThp5i1;Qe=|_N%LzON23oNT|pHKTlcijIX1g
z0qFpLPNr^c^MQ|}0Rpn-()Bk8=?&942hdqeSgApLs%eG;CjaJf{&mmrG<0Y12eF|z
zpbWw09WnM8oV;p`IMh)k3|N{L2}@F$FFcad(LpK|^*yw1F+)VX7{w`Y3GdeN7WQ*g
z=Yui4H=`ZRt{*+x`4A?K_IRBnD>MpTjf1?$knapK3SEHjom4*ik*N+RWYO(h{66%%
zvYAPn^VP{Hx9k87_`H*H4LKMxGcHZy?rU9%Nn6AxysHX-bongRbuKCjdz0pS=z2`S
z%)z<HTF-M1yKs??de^4b*KrL?=61!P#LMktBfY`c$6_)r#IwnS9sS#}D@8CDsXvdW
z|G{m}?-NXP++Ka_2l5kMgY@_V#!o!bVRy0x%1_im5CB1Py15m-mx;_tIUf(O1pAjC
zsAgv2e!xGLm}s+|E0YAz1LC5Fz+5VlMX|b)sTzb){NqYi#U;bligK>Cf4kzxRe$}H
zhc0{_r3uJImWuF+7XSZ15kAZnb?k23U%Lmmrql-aLj><XgedO(4iYhiAie{b3PS&)
zN)W7<yYi))3?&_)b5nN%Lm`yQBq^`si4IdDO75d+YBaRu2ZN0<qw{{N65w~_)`OKF
zS@S?uEr*VsvKKg+4f|0;QQFc}65<GlN$AmUpMHP46R#?yh;ULrekg+qvRC5-x^Z7>
z2{%oXharI5(w;EZpC3K^>`38<MY|;GjK1E!5&iTG=5x>^Gj4cDS#IHEwd^Z##hM=R
zm~RvPggcry>n&smC5=)8x+KM}k2kLbNJlNC4~$`l4-I#N3c|2*t%pih2-1)5#D?tf
zpefP{!xn?}9tU;ApPJM@FRYqh%$ZHr#FG2Dx7i5Ediha+HSmi63~(Iks8d+7yOIUg
zD`*_Pxx=TVDRA0*)PJCNcy^^O<%mQaLSi_;_-JWLKdwb${dtQM!3%RzYvmQHPcifL
zDaPo`s5D&K<#4IOJms)73zdg{vH4a3)O|;Ip<}KnT#BH1p`=7~A`#ao!ik|}4eCIv
z10;{^L?irIZ7we5iK8sQoV?aW1tVjTb%X2)iJ7>CBq^U1%Y4vTNv7NchEFT)a-Gce
zD=U<|6erC-5rcH!X0|LR{nx@h<Yct2WSH|@rx55sNJ13|v7)<B^7NeQ6r{+*78U^T
zdFU-TSbb7w73z${P@Cn1jyV>HY#~-kgDYNQDYq^hooc?u4+C8&bj;R~!4re_hX_T$
z@+HROoabs95_8l0#}82>>g|_>7iv<++dXI4oG;5WRBl#90X!hPj5RMQb0}y2^F8kS
z`%3W`EeExc;Hqj&l=G1;GjOxzk)Ta<TY=77`<dw+<@!UA0^qZw{COm)f&un(4X_oZ
zoU+|T*)~p6CZE{pJnHo=;BC*ON>wx7L)|oMg0J+~PC+J>CcI8652*_k&q)yj%FCx8
zOBt_rY-PjtH$eN#9%3G<+xOo;u#>q|wo7c}3M|wXv#|>iC5rRq(yw#O_p2b`JU3B}
z;Ud|`8n@8)s2yA)$t2NAyios%$R)i?4ZIz<HXzA;!m_BHIj)MKGy+u~nW_liqbNQL
zL<<vn_ijObx%imBww6oJB^A27D5v?NMLX(->K&j4`*lSZ6}_!YjHgkwvJXWe{ynos
zQ;kMy8T#mtEDN9U0@AAnA#8&jK(wClEVy{Y&BF;UeBuBiMD%7`MvLJGrGpovKzWoc
z)eH_D$~*A^7V_*=91xF?U1d(D6Rba3wczmg$qGyK4O#nBw;Ikp07!e~eGsuo4zYna
z)zRR;T)~ZgVktP5t6is&aqt!LHxgj%iBrR*^v#j4F{pDvIT1$q;-nO(Z~Ez|wyes)
zI_A4E#HcRla%g4(ePES1{CU;oLJzu!&}%bXK-QO!po?!>ZXVI-Bfqj&hjUmGG8(HF
zw|nDYM?)YBrfdGz+$eh%19146YQ3A60zo~{;B7T^=?q?kWJXKn?T0Op=mv%Mk&Q`H
z=Z4g~OVh#=58@3rmNypzO<H(g#PdEF7tu2dv)5H#zI9-_^O*a$ymKtIv(bKe-CliL
zduIMVm%sFas`b+WheY3PB2<R%g9^jU)qntncuS+Rl{IZW?dL47tbTrjcH{0AdKCsY
z;^b&>`3`8Taq}M6Y&>9@_VSWnZr>)I--&m~G~P=DD)(Si9V|&);_&sKyVg&h20QsA
z!Q7cqhvSWQ5jq0qe0>YU?)1j9Y4ki{^31y>$l1k{-3sxxTuZOG2~UcWaW5V(2t5-P
zsr)>{vtoYkfw~Q#j1%)D;R2OSJh22VUMMFQgSe>twd6{1_-R}XqI*!d;ex@p(Upk$
zebuwDS;K0f?nV{`HbTx&CQlwTTFzPOJ$w*)<Uv8i$O8nEd~~Ur`>_unWNR*fYFQ;h
z3S!+q(1z1Z=(|=RufbB|!K{wjo>@i#z^&r~zPIn-B0P+iExtanX0}am|KgL>E{@!$
z16=@pSTK9q=SaM<25`C<o;Mi2MqNK4tR=(7TKa_rPCCnM`pthdGgusbg8;7F|Ae!0
zc^;X{R1KTqTD@MMgs_F^JX^>-qPt5eIO<>ywr6)r8Yy5&KRUr-Cj)=xiH~EoWyd`D
z4sefmJfia8w5NzSth;L2;wiT7GrA{6e%p|CdIRbscp^H2^`@hKye<F0T)b1Dp;Q~v
zr_)!@8^B^!6c4AIK;SLua=|LY`~&s(iQ8=Xx2-W(SpO<JA^=HhFyv+Cz2g4JApMt*
z9)Ey#QW<7T+$Q4qXb(npr|M|ON@bbpJl87d;KoV)`m$V-j1<Mp!%Q8mHJzPubz(kG
zP)~i_(w$n2b*|{p3=S@;-6B4-Heu$kjuq9usqzIdRZt0*S7)^**hoxv#9#f^{)89!
zx19U4v<m-h?qeT>R(NVAUpDhXeT0@e2ATPC>f^2X$`;JhJk^w>*9y|Mb!!Jt9`9n*
zxxr~6GxQpvQ-`cvebRkkgEAzFtsdj*?Fhj~cXMutvtXP91%5-TO^cW*U~MPo@7y_*
zvFm!gD9PC`UDsf}?!}?o$kR))Er_GahpPjq#=-FJy0eP>O$6P*(=pkt7-cr}5YP=N
z_x0uHn(-EQIKh;?U8h<hq_ENQ7mjKR3mvHPq;k;v%bMngb;ap@l6_HD!!7E>wK_G(
zW<|ecE${?*m$fw<K2lo06xqwhsB7P8HwduAx&v-r0-<D12FpOlo>kv`EvV=Fa0|0e
z<CUkaqpe5jlQD7GJF8HUg_1Jg-Uanfj5{;A<&OFjCvSUM(A?lR@>#^Ee`$t^j3e!o
z@!(p|lbU_N_lV}SX_DJ9L$dWWd79trHxKrKP59%SQDwuzp6W}UgY}<t%?ZZX4vNsb
zl$4JRZ_AJ9+agEK=2i1tH*Mdo^b!(0@)j+_?#*o*S(m_A$kvu($%G2D18OZt;}y<q
zjIm=+1tU7&RU~BurSM&Csm0z4US!l+m&46)K6+-rsbx^gHhnd69bKW5i>Bc%+Jp0q
z&5n#yuko5B4Ozdq)(%5_B#(wbhrLb%(dAm+`cF_Z+sMpJy7~LNoLx2=oFYc=QT$5v
z>+Pr^nGQ0-D{ZmCK7Hn)lI7~nK~PS1dZxM)Xgie@6UA|-oIT7%Niw{96QiU-PBO5O
zJCdW(c=g?47g{19+{gWTmUDv0F|V*B;)Fs)TYDfUlqU|J1mUGcj^Ug$KC)g<2^@(m
zJ8c8sXyCf?Si2?AMl^TU3|Hw235_BSJ83WuI+Hd6;JxzmoKPQ02_2ICkuP?d^?GZ5
zyu-a|q7%vXpAa)>J;rl+c83fX8C@ivI^sf7++XV~;J<F~Odze6`0kSy+f(BE=lg-F
z)`Mkhu0sIvjFzIXi+d-!Zb>9*y&lOqsqIEcAelxm-?hSoKYI!OQHS90_o<pS?;PwK
z+=tcAROs0i)4V-78;Oy?GPmA%#EM2UtB*aTuVSxY-9e;0wXh$G+3+pO&7fZvQ_eg)
z!oKB_hdY#bbSR3WUPOg+gi{lDT?Z`WHXU%{!=vh$>PWn|$U3@V$(hJQmn)}rFf%)e
zA1F@c%}RWEmgf&k`M!0O>R^c_nZbCuYB+4!{a=Kzk~YnY{cmfe5lEVSeuL{~Z#a8G
zmPqa$q;D_3(as~#Lq}z^_L>5{p$5cwpV??Asum3Cxq%a%;MJ+*AK8xP9?Ki<@OJX;
zG*89-YKIvo;W^IU{qlB~oSq}q??z`d*DKRH@i(qM)4tQ7#}X9$;<SYmRAc|BWRjcc
zt?{<ptGgZ(!JcXSTubyB-$;(<nFip!5*u`4=9e$i-vOuR5nm<;YWDbfGe<h=wmE{i
zK0vX-9_dZO3#4I5Y%Hz9?NFy@tG$~K;gaBfa}c__j`mofPLK}<nd=o}VR{}86GH{Z
zHwg_t;!=wJ+ym7JbNUC8O#99L<&jfpt_qk1*m&PIPr~^+lz44%z!6JH_W7cg+D?i|
z3#$G6+T!xJ2Tvq3%_aTTO}Aw;+t*<&tO3VA^sn37eQP0GMG1iqX@?*zdzO^-CW8#S
zz5`UzrB3DTuv<)Ssx<-5y>-*U(EYuZYcktq$1k|=fY8c>#bGgVAJp?V{i7LJXCLI8
z=1pKDyUhjW_!`i)g_ajN*iVDAb$HH`YCS=aWh&&=z*lx8v#lAcR8yZ(tx8<(+~e9n
ztb=>Drvo<G6}F%2^CbPTMt=&YbWN|=`4QW$jYQUZBa%$+<1hJ*B0)a;B_2;^V4##|
z5%DyufNu{_Id0%{s#5Xjsw)}d;kEZ!1Ah6iQXKTH1Gi`w_#L2ki$GScyO+YrT3{#<
z_3eJW8!KbT97hU~%(oeyA|@|MzX{2L#gVo!8tJX^OpeAdR4;CYJg!^#nZ@jtOY@g>
zmsQf|X-ZVSoX3j|(o&9%q-GFPf`+2iXmZM&--JGGDa{l5WIfgHFBfxG{)x(C4dJrp
z1e^b#<lg?rvX*~DY5$g`kjlfa#@_+4UvU8!ezE`M<rz#~d*9@LlZ5g=#r#7e%dt^w
zimcq(LI)+~??9=BF^rhTJ|)XNHZw<L0xvS(`nRfTqnxSgBbH7Vk$7eGk9U^mWMZB=
zT?`ZUh-}o(a(boRd?&x?`CF3%fiR7J$pg%ZNe9xXC)&VUS-D-1|AClqf7NKJ!GMdP
zd0hT@!4%mX_xAl65V!k%cwH0{qcJd4go%)>^H3WQ(*@z8j%f}tV)O)a81+%f@Vmc>
z4p|}LZ(yP+FZW9D(`dBt**s%O;Pl8+2wM1hVGi*5dvV9mIawYvoth56(8Cyn&->6w
zP>?_oQ_p<3htlYsq0h%|Z>1h|qVTZ9#^X<sJ@vj~LPfSFxnz90<fG|=#YA+E|B~a`
z(lxlm=cDx~THdHth~D8m8%M!63T%mJkwINx5mqSQI!)B41YbV(>Q~%v*0MK+w&0>l
z+Ar#~grK2j-}t8r;cH4TB`H}8vHeKk)69-R%}3bushZ`P9DJyy=h#?H`Ie0WL6ui}
zoG?C&jPI!frlGpeXJL$rBo6RZb3nRAXUo<1>U%G~Q=Q&KTip|H!-!b$9LOJ}NbZt{
z>bI_oG|06C@|0bHY@1-kj@(sLDyAO|8s?vGJp^wGI{RYdzH7?2^Q$1<8Gn-Ba~28Q
zlR-qiw1%Z<(m2%8iS=^$`0!|ed3G_84L{N>IhcqE)81ao<R9By&Q?;2lp)*)GIie6
zq;Bq3N~?BfxCw8<Ud#2CO|uuMf0^$0yt`0iB9mFb4)cp0l<#YR^SvI0X`WG!9!;x5
zcR}EMa=?e4Zw-}7@cuWdR7Mrq*mBSe8zvGA@BM8Qog((Do~X@HA@{5^mqP6OmS8K#
zD0cb2hwhP}EWXa%IfLbmNlrN<fdrYv(ZG0`Q-hVNjBcG=rL4VhgVr`Q;RKXZhjeE7
z&La9lOi~6Q@vSKFdT3gN`UQ-oVuL;Ny@mgy*89(|XSVA2H((bD-kLxvaxjC1za9kr
zo$frhCFVcN-V%Qx!1;feDOrZ?YE(|={MCYy|J{>m<iAa(^Z)B7Q)+{A;lOVFY_y)#
zko|P`gU8una1{))y@cDt!dLIsu+wzLX!#B}bjBLquvO*Zn&UKo$*9S(xj=c2&<fwc
z^1=u1yIH~)p%b&sUrXV;^#NHchjT+AF;+LyxO~obt$ACw$&Rdwbl0)062j6%;|uZa
z4V==?rSlz4O3)t*Vq=8ETv`(kjP(CX2|E3;TO8Hl>{ge?_u;IO`f7{YMSgP0J#{hI
z`S53sjw<~c7f+621YW&ERi*GqBL<04tcRn6sEU-zi=D)I+!tNcsF%5tW?sd|yf5jD
zMh$6%l7$TXYH+Tr+uI8=SiP7@s$h;oZ-}@Jm9J|px5qRia_PN>`LMmER#t1{@Wt`&
zb#w`b+h@n<{33XPHx*T>LV178ALg}BG8gcea3455Hl7_xl9A_cy0M7t+;W>XST0tm
zmQtU(%M*f-cP>E^52Q8VFth#3l(H7ATaISG)EZ<Yy!_U@=yZrc2JF0r>ReLI!cqAz
zvdRxa(COKUB`Y;;IqF(=n(+f9e@hrx(s$k3Oo`@-klmu9r>SYGhvgd;MY2Z;w?ruK
zpF?iHD7yl#oW8lVkj%ZPg3dkqfwH#Ls&rbH=lrmDCS+D^42Dt9j(}>VUq`7u-x^l0
ztM24(KWpQh?6E%X=HTD{#?WIdiY#E-*&aKcLd*>j*}%%Qacj)wFvyQWW!gp@mUfwh
z3~xr!65Afk*a(>jw}lPtT-`EPA#9x}!!r8iYi@^#Idw^O*9L!c$fE%A*O-M=?zJFU
z&b>HMpRVDk9U0}hDdkF2<(Mh=tmRh(Vk0_yA;)Az$S|6I8K)+zqq#20tpUN@RS2b@
z+eiv67}eKS9?s;wbaB8|x(*6QH{6?xAo`~j9&<3#&%qo+w#iOgnIw&#6JTT925S_X
zDzO!CM^fwxIcOC1I<}Dd&Ca@6PtmkR5^4D!pWh@z%Q<?QH_+3YS)???mJsb2P6=Dp
zC}%c<X?9#O03wXa{|NW|#3c)})dqEvO3$V81hCOga@68{c|?x!3Pa_9*Ug!X1}4km
zUuyCDSnUtQ*!&nF%O3{%e_DvyFh>tH1Jju~nZL#~(0oFwi4$XX`u=wVKzaWi(0~80
zl;-@k+}=O?cvH~c#?deRn@HCypOe15`%G`>)B10c4EvcfUO(W$A0H63gVl(ToM$`5
ztI1K-BmrSlGSlY6rk}dIj!@k%_OF={Rcmg3OFQkhC|#MNPkl~Ez;eeOq3@&=fPlPx
zxx)j1OT=4Yj}BcXH};)wkv6;Dy$W?fti0y5tom4VYq%s46OI@^I?@mLNXGj%KUU{j
zRJ7Cl5*gb!774Q4i)5c{+Co#m{33mB{&?=Br&jRXtJ9p-=c9aIV%MF{=WF*?jN$GS
zp$FPPyG=xCexsIvQ}!;AE6gsY7IKldYjh|AXR>=)?`3x&y6}`kH4>j16c^KTB4W|H
zs%eD>9EnC~7Pba4_OuihG!$`Il2O`YCWk`XSKz#o`yLEskj*h&X^p_k^#S*$jDCaO
zs~wY14c7%xt%+Jz7OmUHoGr)~$%73petM6+)As838-{jjp(T?<5wTPE#YG$0O(b`&
zdSSEX*m~1YGnAYToo<~5iq?zZhm{?BSyqbTEBBTBc`OEBO+U8AzxwSHvnOb4k<8e8
z#=UJ9E<N+pEmiz*OPNu<EjS-zp#pKc%ks@_+H7;?)QQ=g_UTnW^g`3tiibv(d`rA?
zl>zS6XD+->%KqGxp7-`{b=J)V^1x$+MwXkZj~>}=v06)cSRUwjv(+t(K@u35iW;n;
zU6syEKCn=4<@4&dTIrhPDaCJrK4nx5@p^~kZL5OyINq~--E?jK`ao_TzkF#Qy_g9T
zCoL~Fe`sl>sqNuC@|tSaMcw)?^AR~W@C7%ACQCU=_-rWdpj>$7UHx$KxnP)0oNu~V
z#z|Wm(cO4T$IY)%llA!g37sulDwhmr2gPpac(s+6e^37TygmLtoQtd9$*Jnr9y13$
zLc^6kU<5~w*AuTud6?JZcSyOXB{buAo6eFYj3qI&VLxWb0c`f@@$kw@X^e8{iDy0g
z=|1OrLV(H68AA20Jx%)0_}uo$hJ&V7qDi*&Lg|7qKdMxUghnrcIx-7XbB+)lfi%uV
zG$@slSTG}PXSy&c8VffDg9Wh$n+ix_U(m#h`$~#l?4eKFSfj3<O(-$VuZA!cGs^!o
zl>bTVY~QCTRu;Bw@|hD2Ov&pI>sdQZbt;p*CcBVJ63;S{@h9n%48WbPIz%@AT98b`
zk9v`#A}}dQaZ&9P4NT%zaRDQJc+>C@On&)8)x{6x?3Fne|I$k6=LshDtK*9Q+(RmW
z>JWSm^KaMRXb`*c`;C$mSAIHp{}%y%Y%S6Tz?>cbL&@H0<p*n<47z%O$>A<&pESl>
z<24}HRe(jnVBn9@{=EwyhyQv<(f<NHhCTHMFv9fZ3D4isPwd@dR0pe5|C{9Ff2K_P
zpZ=;TLThjK5mOY#hs4A3sWaSnN>Gq)wNdv%POoT3pUq}#e6Z6Y(Z)9v8ZuXt5<gh?
z?P-VFBB6|7vp<f@4m8crC=87nx19EqI*FFex)(oHd6Y-ktTz!YqzUhhE`717+py%e
zNSN@GM1|yQ_=Gw3WIg9V>yq4W89A23bwQwQ8as2`88NJi`wfRu1n)$5d~6DdPvf^E
zFa#c6cZB;TecH0H&_Yzn9MNegwz|2LCLaYFh4#H3sEh6A?XW%EqKi9NDwAFxh9;f?
zLoF^JWCdmVe4h4r!YuSx#VP9*-*p!0j{0=Y4)ahdfzH%o=WMY!lz;u$C$jQ$V(-pL
z%PsaBw_gs3s%Kf3%A#rhjr6k|><)y*YeNsX#SV$Qb4^X2?Ui(_Xiln{-GDTfI0y4?
z($1Edp%(HU^&3QZsg%HP$jIQ=CRWsU>-8!zGK7TZsBB3gqfE$z*v{8p)ZsHKPC>Bh
zE1BRxhEL7<@v!A<dFaRf8gINHBA}*DPLSW&kc+d`MO&p<SzNK2x=ZsDwfdWi%ygx$
zNgQ}bxJu9SY%PJua*j|(+dUclSioKBNY_SHzQKmyy>mLJw+$dMH-#icY;+aqb?VAy
zQ`1!s7}iK-(;TO&GF>y&w5f=cmkoHK@YIz0N?jj3!>F?XCK#A0S{-v))~@Busm6kr
z^FVwGJtg9Dd2@XGE;+OHQ!n2K(6iI$Fb<PIe1tT(X1)qwe>xbjZciFyZIe#cWIEBH
z#JZuTTPs>-hb<>svR{81b8H$jy&m(_DA+K~t9mf$=DoXHz*{W$ZTYx};qI%1rr_5m
zLTgG_lMmuN^&Mn9GGM`&{w@{+(k<Dr-v-m7rzwaQyYl+|%UaT1$0h3$mO~J8ZYh2<
zH<BuRbXS=5m|7Z!G8?#%@GMwH&As5~s|)20?r~7w{QTs`4;>O4)U}U=c~>vsIs^ID
z5*kL2mH>8ZN~dW-w(?O#g7MCIC_8o|>*lsvmAIp?gCf&W{HIh#T>H+T7zI^nB4xi&
zGrLFNG{wUBsd5llmu<c-0%&V;9@ucv*&A5wR0F0t<|TP~Mt6G$nS4xaZ#^~T!A4_0
z3S^39mb3}iUa9Va+$Z^Q>oH2Q%r=hj=am<WFkzw7)MD4Wqvx~+s+)B<@sajyif)H7
z9DbSR9NE-Z>R@27E)AV6HwajWldSF$&vL5b+K@f-2s}{t#VU*jIFE2*ia?ZB-WETY
zla*yCGNUt&v;0Lf#>*EmG3^|uI|_io{0kTQM#9IiE1Frk{PB3ea3z(X7(aH38}5|>
zQ;_gyJC(~Cjee_wHXqK8rq^>0C-pOTs^Ta46>K`jqwQ2BwHC8aO>kVXJ8pUX*AS%n
z9v1NV??sRPE9d_Od-Hph5YyiLs2O6~oBZf0hq4xB-0?(4olWMXlYp%5Le*tc+mZ=8
z^|Sag5RWY`L{uPh-LM3&iGD<81Dr(X`gWhD0!#Z4m}Xg5b(+~kg;@CFe0&kTTyW}6
zVUDnj@K>x)I*Nm-i#Fb~ZZXiH%qIH!n&^f6(vTA7cc999_Mku-e>PS|$NX5SB5R%;
zRu)m1$e)cn$sOg}y*d@ANUy4fIb`Gln1<wcpZt%$`9E{%-1_Cip|6V{NL%qQN>CcC
z!YfQmmixcmlI6FZHAAH(qSnfJ4+iI!R6CqMuj@_l1=e#kG~B!_p!@1$11H=|7%^(%
z_bd(-7^RmEA3~03AE_dcx>AD`2(h2uTYz{m{H;y(P06ETc{)b+vu<Xj<&K`3QE9XJ
z7AJn45QXjjc}iU;ijC2<C8u(R(IOvOm9Z<EY^2zG9-5`aa~<DxGWG_v$f8`FJQiLz
zNGhB4|9oqxWy?V`4J1x*k$thlOem(Z-pG`>1bvVq9*`tVMm%f&rO+<AQ}U60y+-7=
zh}pH|BGKX$ZPKF^(l4Kz9C!DQYphmVXBI=b03N&b#VKB?vX>~@*1dpBP~@B2SYdq?
zBW*En-N1)>(}Tf?rxF`JZOMus>$*V>Mxw1wgnWOZ?^(^6KDCyz#4vV!9|m>mf`gu;
z@vq%weN^M~t^q+jTv{1+(U->g#o!#Jhd9&WyJTCw9Zrm?XvpzQ<at>IP}zm6qt`RV
zQ71P-wjPBML^Z9O<GyZ$sdK|gUcIJ=>*{>EhX_-LO+;`*<TpMC2opu7lkeO<&}pt-
zboH}#hq<2}OD^{9H-YyV%}z%vPN~zvz61OTSaTiOr^X%JY?mvgi;vkzd2ra69Uj5T
zerfUZJ+yGlU_LKT;6f%?XY>;5XroMz4hLDaSk@t7w7Y)KFV)0vmg{vI<h@1M!E6H(
zqpV&XFVZwf4lt@=>H-M+wK~}4vaO>dl#4t^U0PY5W4Bz$Rw24YVb32Jjzs%4x(?jo
z0;ElEGUo=3Tb8TJL33?ICERW)NrOc<3$Py=k`YVdAv7e@U`*Gh&#R=)S0b=^LK!X!
z`KtU)PG_jw`c<Ou%04I)Tz8Ny4nnmT6bPLa`Sryz^3>`0de$71q4!8w?7O>OC-JIQ
zW_d#%l(IZPw=S@FxunQvE&8w}ua#`4z@T#C1%Ttimg(@Zyd00$MxaviIX&I@!^1Cu
zQ=*WKh=U;)EiZ{XURIGq82uMqR+hiv8qV)eDK;Tlv{NNrSgFbiq}2@r@+J#DOT7(b
zoS%Hv`EqSk?NoJ9gf{4KKGsc@eXwR*^R4pKzF%rungAb6(TkYXqxl`6Jh@CbAeC>d
z<~-q>nI>qpOwhk)$Sa_;Bsi+JR6-~it{N`q;PB8&q$x(6O)g~~z7M!iBp;STKqx0x
z9mB@nXYMdjYC~Ed$jDPDFfTCVng2$8t7YwN0A?P$XUOH7`9V`T;{lj<BHw>!6rfP7
zU_H4qn06k2?#HtM{@I3Vyz(m_YWMwaDNh_g>t72mUM57RR{?*t9sKK<)IWO8U&6GQ
zO{V?>(i(+?S-d}C3z_u>0jm`7cl~eb@g)<S%W6tn(`&M{gtTWu!5Bvc8GP`MPFl`3
zTbqpHw|37hTI1uwC9rQ#{(`iAZZ-=*DwQ47xAzI(z-moxm9q=9iy19s!WS!uKMrbZ
zH?Yh^Y??87TC6GJJZx~Eu=#XqP&o(F&S?9dss3-XF+c2=e-A|2LlE7##AEgZ^}Ip%
z=+!G^l$mx&RY<L@pDj%9&9<!$ng7_L*`h-|pPjx}^%1bF_&Y;Tgs8S?VYh|eDb!Wu
z1ly0ToPk)se0aEG;D>Uqc&MD|DLS*W^v~~6^Una;{?w4$0C!CGcm=F?O3EOje@Kv3
zH303|vYrWRd|;OP#^><ql7YF~2bwLX#LMzPKnFIjsn^^Gyb~bKB~fXdm`Cf#9`&TX
z%cF-8#i15=uLPWm@;R<ig4%I=yxx8c<~MlKq92!=u=s6S^#$>XXL~-!{EZw&d1am1
zV?y@u@sVHDDEHlJ;2F`0Zqu07`!QaYy9Oj@$5VRwo^hwpC(~=?D+&-9&YwLg(iUgU
z1~r`pRIMO)*a+iQ1aMjlJN=!wOvqbzYd9C*TvMaw<;FgamjZWpiH{$>GDf8UphIqo
z7B|nbUlP1l4^0e54d(skf55$kp5`H2B^gmWH{bVC^Smqr3VhUCl-lICfu$m|M9sJo
zWhd0V^?V$6p-&Zg%0J^t=WC=@*OM(M<AP=yH*T3AN8}qFvcd;xP6_UNR}o8S*UlIH
z{J+LbyXszdVs+9-yC;~R%VetY`wgztxX5I();2f>ve}j;6jnF6IPIx&rAO{j#(JU*
zl=xPRl#9gU(ejE_wzGy!N$VJ`@f2-Go|CFCN;fU1U=CJgO4{=HCav1Y$=dv1Xb9J~
zZ90DRVdqhmByknHfH2`Sv#+>UU>U#T^V)YQlds1m*w4GF&0UP1ejd(t*|cz>UT&{w
zX)Bdf-$%_=HHVTuUJvV+E)hOf8lWq5zCWl{+O;8+=s9*Jp#6Rbd#7cu4ygBDu-AMG
z!ch>K`CB<UH8MX!ar(CSI+d-bK};K=`sQQJ$Qz3g!P!3aVfl`|3_}agPmB*EeaQF;
z`*-XuUeQdAF*-FP6tCFuH<Zu(EhRSp`JC?)O!&$Q?oB8?9vxuc&{{~;$ggGR<;+Ob
zObX?O*z~qnMSr$GDnlei+^H6OIu$2fSv~(S_rf_#03Kfu{Tb19<#(-<&2<ar8cS~O
z*WRi0-l_Ps%F-WoiCXw@m<SLs3w{RlVODlBUuy@4NdmK;D2#bf4)_MIp~wPe9_+kP
z4bZ?}eZ6kg9?g_TL3Q^3cvw7BG3D(!OYJ+=%;?36d4J}Ue<&7z*!_J_|2`DfB^0Xj
z>C}yWgyA;qZ!nAhSJP>uxq)TsvcQ1de@r?2QE%pt-Nzvc7|%^RTWT+(UYO}xOa0Z9
z$Uka+{*LSU+c2@gf_lkDl&o1|YWowpR#OkoXp6aUDHlX2>#x|&i{vo83HL%$5`0uk
zk2@HYGO$qSHx|-|&6Y&QBkV2wz>ie920zqBZO)-B6<KH60sI*)VnY&ue(CbcIN)Ux
zPKr@o{^!htpRxV3aWK-Ww(Qq;Z>Q8Lg^z{=YW?c`-tfpZzvuz#HNV6A8!c7TU`SRn
zTSxWG%lEWvrvRhhMvlLq_W%8FfR*>PanNsT|8ZzQCsTCDlbW^eZl5k>XviHh07~Ks
z__&omFj&s5Qw4g$&eQLs6c<7`r~Do8<5D&zo3^od_{@)c|NFjzTFL#sE3iu^4rs(?
z_W{eUJBsx$&qbZT=M{HKN}`p6m7!JHRNrkLr#{>ITYL9wPS&Q&Aaqf9nvXrlRj|6d
z)?;DQbk|$eCki&Xzg=P(@k(<-EMI%VeB912>v-m#;YoKTb77I}BS-0u2Fva7J$CnB
zD6-}=vyhY0k{N1E$+D<<#CJfM(*6YJi9{>>`fvBX1N5EVSN&n2{~vi@0uN=^|2<>R
zRy49xh%uHBB1?nDzRegCDj~~+Y$;R*QH_1iSQ^VPLsKbhQdG8z7(<2Bjci3v)}*@M
zGrG6uUY_NCmiPVt-_NJaT-Uj-Gv_+jS$@m+_x(ZMbe7ycfNDQ1)KRaM9Tk}FVSe|m
zJx6i|GJtV|ZJpslFy6rq>50PDp^Ibqdo9Xw@Yq*D_FM)OR!*Tn@y7339Mbfh;xkBf
zqxS0EZVOL8e>l>ESD$K*xH~=k7Hex0HVQ&2ij>T9qNfPGoazLn3iVI-?-knLuDdj@
z@lZQ^7S1Yl%~`VE+{W<H%boHThO>jW;Uek})%Hp)L237r21LD7JGAy1nmtiR8-^}W
zw6=*p>QUdlIr4%K1LhIpaipg-eM|dyrQFClC)pwksohy}Vre7RuEBvg)<FWKdgqgy
z*9K=Wt;dwdqq*;vSHd4d-yVWH-lwjUd|=SRFT{OQl+yJ*Ux@_zrUtM54WIhnTv?mA
zR|xU`9s)+qwBoB5iQhvE*nQUmK)>ZKmLVSPexqtw15Mva>%Q?y{McEP>8^QWf4-zu
zT60yW^vMgBk8kYv8&T_oK_lB@0D(}F*_4n7SK<Oi!pU;hRM$MXMN5Tuct9>WK+<`^
zOsH)jKR-|PNN5qKk%QlK>YgXN+tgu72dpl3?NA`m_8~a7X9@A8p@ZQ@F+_hpI~DaL
z0P9rgy@4LOlIbAG5)#RH?!*0njS#3*v9PwU@kmeZw>MiX(Ja(wa7W|oy!ndyG|D4F
z;psxu6b#BPa_!Rg1lczoQY(@c)H~ls1Bw3#%;R<{{M$%g_#QF?Ue+#D*a=>{1uGG^
zC7Bx)7au5^4B>bD(%$?pd}sZ>?}u$D&rb7^h*|}QELoetW-iU}&gFWkLz#gKUE=kr
z*L)&iDUy=)LBV^2xL)8k*2{e?X2kMmn^H_XSSw@y1W1}4Qk1PkZJ`XrN)SVB<IQ1R
zQR#h-H+{QG+P3*tzR>jgL}%$1a#a{iy5geDPDIq%(L}*(_a@LX-<sOdAO}mTy!tZV
zTJvZ+`d@L;IP3e<)sR~#r>^Bvg+aVBsPL?B*D{HD(K@&q`9sycKUIjog))=ES^l)$
zGb36xAwvN9{o^LXk5vu7?m{Pu@^X_x5a%_NLpTFtYlxp%%2*FJjd+JB3W>Au85}#j
z)GssNjWggF%Os|k8S7MB?Td%dcTO91i)igB$iFp|U7mD}ou!eVPe`XoKh)-6X0SZI
zaT}jJpY`I78N0=CkT|fEm?v*kK(FZxCa_G1XgXdo-0NYD4@F)x>6T!0Yiwf+tI+(A
z9)ond-YvA(M#N3bE9F{94WGtdc*(|l__4|V=}%#m36Jm<N?CT^jVR1;^wo;|Gu3)+
zmLnzd9_*-0r!%w>AF?!<!2XWfyj6pQ+LfbUKA63@u-ay)MyPSTerxl4g5i^WcR^|~
zA>XPa-qNpNXD>&e0TEP)KBv3Pf_1g89|0qeV+n1eVB>x@=PH!TM!~xW>ti6nnA49H
z-y4Rl#e2|%l+#5%6-<`=>?HdaB$IzP>!#C}V(DW?Je`G#ee}~}S++SK#g)yK$(uME
z$^-1yfHUvP_mIPvcX_hT>wH!`_fmTG$O4J;=aOV9Sp8lBSjXG`Z-o^q6aKBn4Nn2X
zshqmi!spJHH;-$NY7;)no)o3!$i)=}ovze~?zA|U1r7Ze{rcqL0HdR69k+C<EIIfi
z1FuF+=Uo#`x8NMYgWVH%eHGzcE0kj-^~AgSOkVWuXhijKSYl8aRpOI9#}s8rD>>qO
zi1fXSv};puo$IfBSpP_Xyf`uTiMxvt{Y-&goB#1{>`g7{<*p?XU+}Z9toBdCRbpcs
zJE>+zKJt0vjx0Q#L2ix4Rjk6rN-~qPFIhI54dVC4o|0HOHgoWH>PSirC+d4h_^oB>
zhAe2Y@JQ;6b<u>YOtomY;jTt$Iu*BX7K0aFcZ_Z{Td9l=sfLsIi@g@LbwoxG@gG@U
zM2}X5e-D{0`Q+&OJ>=uckyQ#y_m$649rmxHJ3zlhl52pk^z^Lw`;W`}-rIxgJ1Cz9
zIx-(^-XYqC1)-Cv=w<4)=m86)P;~9q^{i;nA4=N@kQtc<*Ncgi;W(?{RKyXoLqC(|
z<lbmiz4Yv{PxkD3TMT<fC$HanH!_vRY5DZV_Td{#TBOj1<oxV-i2YZ_k$KFwu8qDm
z4AymS^a+k=hCNGLh^nWDa3BKEu|+r8Au4IrK?q&ucccVhom8}Qut09MyJJ|}pZX=I
zF>HPO?IGm%kQctJdiLpko<rtWpBkQcPwZ!)pUd~!(Qkgvi*ATUK=jw{-HqPc-(S`h
zs#H|S=N+N(JtXL>V{yg)`=+WD6_JqMbsLJrz3m>imKO60QX`+i%g#K~70NvN^)}LA
zn$;%6c#7Ugy*F6TcxKrwJma=hZSLg(TQ;DuH2eA8dz(t9tbrQCm^HS)RUat}Mv6Ti
zo;_|zH?B_sc}aJjpk8f?{`eIK88PFdQx6@XHLacQs!09r)8NjL5Y2bSnIG-hU(I2^
zzOiBd^mKcw_ipDR>w7QvWxH0Vpc>eyFzC&_yeqiQeG7upM`m0eRD9;Xnfm$sg=b*+
z)vq=Wk#ZIvrL|Y*wAsD=y3B(xeMd_J<Jw_v4or$<E6L$T(Tn(~fz%qa*=SkIKp9!i
zed#0)sqtPyI~bo|h3cBzwuw#*%9nn<_ZJfHzsrHL?|b^UEi_r9$S+InC|GQ^|F9!N
zyH+VDnlbHA(Q><ZQ5g59^geV%RzwzW4k7VLg;F4i6KFes+UC-+UdtuA9ZNqu6pL3_
z2p%kOhonR@&V>dSF(wNyd%`+z$+$yXbg4<waNWr&M!R=AJL@UAbsaV@hDK%8QNMO?
zot1LE6S^e9V^ycO?H^&>^9E6PGmdm0qxcH)W6BJXduyjIs{zjUHS%2OvszPC^EvZ+
z<-K@c7N>aUaZ;I8*vnZi%KrBS^!$XUtSorBb&YYoM)LaJEhH%$qp4<nw;K@8bflnG
zIbHXyd0pq)gRpX~2YdW6W<h-*xtZk3Nqeh0#jpF_6*)7}U&;#J7?oe@bYtG}rO;wx
z+yK7q!N(MYde8$(w?feuUluQc0RL;2be^!I89{bNj-T5_!Ne*%_~Jm|?)S*8DwT7O
z#n3o{hK+8Z%!>s5-e&?ruNRTL>uTv;)9l!E{dy&b#EPEa!Kx<V0FWCrrHnE@gTed+
zmisL#+AX%f$L8S})kZjbhn;1uP`_~#vKyOWqLdq0ek=Js)g+d6&L}BdvwJdmj##~U
zp`lx^OQd|QqZqc59h^Rh-}<PvypYx+Ql?Q<BWf`Xhgy49lNWLaiC%JH<?l5iA4KMT
z7cPV%GkGi~i<Thom9A?>==*5)DZ(OXNn$|F{~^m+1x=&O1@d39xBf!m-KKJH5No&k
zbdU__BM<%%ywYXm&Yc`HtN3&kB~$O|)ZUJ^J(^->8L)$0w5%kChqxQS6;)taOs=FK
zzDy<&EsNNBKWbj?Qdm!PRC2*$3R1F*cF6f?mOSkAr4F(@t=C*rAt?GURRkgWFl%Om
z#4VWw&l`^rrb(0@zpqBiBs*hn#jD|ULpDp0Pm0C2Z2xI3_}{JJUL&-|y7I=Y9nf<T
zz-hE`T|$mGLjohZ-mjsj6z;uozBd&5iF;qo)DjF@JGJZH8?%DD-$SxJzK8fdorZty
zztU^ZQFrPLWwU}D@u{jbMm#Fm(TkxfC(>h>HLMz#f!~8Ze>5*uJb7P_UG$^Uq2SK1
zdy7M(HFs;e^KwJ_7c*Zils*L|)zQqKh-OyG>MZ$?jZ?HszFO7IVA9OyevXatm{GmX
zC&%sPdQHnD{;L$dTO-^Z3|L<8W=nU*JfuU&#WhbpSoWkOoV8@AW$CNfBgVZqSLnrJ
z$t}7Rg~q5@o)r@JQWfK@A6z07DTzJah`lmD7+9u8LEN5osEijGBNfeBC7qZ<ihrnL
zOO>rfGh()ow5)N$tP)F<sivIQkS`P#8W>WN29=ZWr=-fri^GAXUn<E`#roy~!7=Ek
zr&L<Fzpz6B4yG;ve(72WJGEoAN?Uxb*hp-gB_rxZ;8xFZ7_`Ep;vIgS@of7=FRetO
zi9WM8*DcTFE<TDE7tw^80-b}8rsK^awH!I&A-b7zRXnOOpcOlfv(Vb~#yA;FBxRq4
zD@R2)57nJRy%v_b-?$!nDJ|7y=BAZIfmAzw$D?Q<)wpO}8I2w+dw6BB_Z-&4Zf$xW
z0&*#Bui!P1#<6TY`Rkl+`g8ZL4ti-}-Tn9dN!*Z0I|md80ph4<ZkXM#^k$pA21uFE
zNVvtv=ncA%Y6+P>-&x9f>W$ULc(^ijN-8#WPM7(tYj5ALVMNoCBwzjYfVlgWC(W2L
zu9fco+AYnF4^V=S^#5fl)$-aVhxAqw|7Gp_LapqP0+=;0%A5pod$`ns&H;gD&VpHK
z#AD{r10xL#z04nn-nFabY^?M{r(^d%N7tHtsn|!Vyc9IEt6(n?GA-0!%E4|&wwk*B
z(>=8czZtGLJ1|@s%;9=7?IAlGd?M4i9JOcE`}9kjoKF#^^dN)ELdZ$BIXN{w*EE#H
zMgs(nJl)bBVlaE;=aykEv3jY77@$0&L4}I^6}lp0c)7EdCq3>29XIqVIyL$Qr@ix%
zLi5gln<pju`~E-Llv(zKOY$q??_6M;%(1Px7~~7(7BC&`QFnOn#u7<?k4_2gRu>|G
zG$(Rr{p5558%qpp5^Vkj4T9B8P=^w}hwMxyaSw|n(`KCDB<^*w<m8P{aeA(2BzDQ3
z{cN&n`%)DQ9i;T`grzpPyafMezTtj*>kp?y@F_K);6E>&L_bFVUr{hX4Q^LG61wel
z%cZrZu;j)AAzjJirhXExRL;zUwN&$X8Dm``@iN@FEJ4O2)V^A7(dB%d{ILrXCySjV
z?+ipL3U~y`yqq(+>U!>QEjx_;;$M7Qsc@2)v!*+v#-8mDK9)r){tIrzUu<hko%pY}
zHuS!YxXg}yMriEyUaX^g7i>jy(9HpdG<w|&7{du;`R2dz6Pu3Rp|-&WXONuvJ6>0l
zzr2>j?M=IP)YycN&YEV!Vc{BUqpv18-8r#R@<43QxNdo15YGMqEYG3G5C3#jfVjs}
zr>i1xoTmC+Q4RM)vtWI?r;wt%Ucbm>8do#UGC7iw^-oj6mxiv+Haj=2FCYH*qfyU<
zXxd6f5{|*3C0e?xEYG()T3t$hm|!|q{O5Qpgq*85BvD7c(i=N)PfPHc!1sTa^0mKl
z<?1ImtI4|U)KHa8D9}mIe3-HS?+=h)8&0IZXZ+D}B9b7VnU21rBGOfbuG1;YN_gF`
zKs6;)SNlG%NjN~2eT(sTu_uKAbTI)g0{k%l^jrPW83KYAf1bR5!qCR@n+XpXJMWFZ
zK*Vn(>LSl;9=JdyD@jFYK93|`y8EF@+Bl#(vafEJODw^-(eQb*@31h<$jVyP8qNL2
z#>i=lWCDrg4@`jRJN|{$@o##B{=s?yhIl!9>zBo4YQT>oYoPj5Fq4&*goIp~v6wpq
zS<~aJWjQj+*wk7{USXJYK>q(%*2;qFnhM-<d4F~u|A9CQ{GtycDMN8vkEwVJtUSWJ
zRdW-W6+&lt1q4nHTaX^UK3O3unPM@Sc1x=K@{;&Ob@5Se9ZBl&5dO(tvEqF@_?oWE
zlh<Jt4doHZMRr1@TdBLw?Zs-hit>_0sI!W-9>$W7Bm1=p#k_}WcWxK?=iNI0Zh`g(
zh4m+8=zqcSw*Ud)VFh|QV@O0DPA>at{%|Uc!uE`6g1@xYWVU5dFwlNX2Kz6~(I4mP
zpZ)x;)tUY0EP5{hj}^)n%+1@x9I5h>!1Al#W}oF=IvOcFkj7s^dGboP&DerG)bXJr
zxRC>3Kx`KZc*oL8;az1m4@Z1Q{2WEwQ7j6Y?7jKP;>qT{**0tC9ir)V1gLrwIN^NU
zM^d-^Y?1X?OnRVZpw{+Sla`7IPVcB*Ha$>mHKFn4E0lbiC9N{V24d3C*T6{F#3@2~
zA*zFeILh_UYQ4q$YpIpYZ55AW?sHAW4|E)c0|0Es*d`S(t_N|wjIh6FCV_eke>t{)
zgKNPREC)Qy<-j#53akK@U)WJjt??l2+sKSgfU_7SNG;u0H`k%+fDrV~=~A}8;kck(
z{~Se3fImr&p<m-Pxr{OqEkx-i3@XjoRBd58)&I%=|7k4DFL5#dQ@=Ce-XN?e-`v%`
zTTavZ0l^&;A+#y)B3ZCOQt@WZPHu}fMdMQW;zbE{oWt&$i$=V;k3EqXTTa|XHyv1P
zI9vK?A`b==AEDV~v)?PjsHKy<D91{c$<5QmZF));gmb=ieE1}9ESnq-y*QR9X>q2m
zjH|no@|C`ns0VL@QgxCq4cn=ibKq_?xVJVVOioXD3aP%4LB&7!a*zZJsl@s~0Np>P
zvEYYO2NV6jk}BcX0?Eel?}6h$z~@az?tA+_N9_c;*l3#_(0d#(4;Ty^#z68V6bvKB
zT$;`^y5t$#m*>!8@U5s~4gc1+_IiPoX_Cd(HW|_y^{vM1I7eTSuEh|_t0U51BO>5-
zNl6UZ<HK#t>mqi(;H_I3tXSVRR@DxD^Qf`hIe`>28oC6pYPZ)Ma>V6CK?(8;zOu%i
zeWfw!hHR}<5h}f&J0S-z6v@aITc-Y&!{DFTY@o-FTdvcVueva9<ZX|CIn8?bG$sr_
z)|mG?W5`ZrO)@#KBjlO(yANls>NzRr9uQ2<^uQ}IjjRAJ@`uW$^G^mYB3MJd@wGUO
zOMztrbI%CvcmtSpF&ncT6BkDW&<tA<?^1nC93f&Y!B<og=o5b>NiapTf=cJt4!E%x
zmcV_d>HZ#iTn-+~2DqDbgM3CiQ*5*oq2Aw_3Gy$y(Av**5~NBh!^X}7oAJ+Ncz<JA
zf$kmdd>~VjZf(YACu|$%JBK!ZuiLX1JFDIlulgN&i%}~X&^8*&jVSKnP9Z>OK_TNp
z>{fe5DU|<BoBO}>Sy%y9*E(~)f9BdIH*S;dlDO7M($Iri)n^9O7=^<%6(ViMCj5Nz
zHfoK!JoeQSW0~?9X~Lv1=aA8wH^+QTS!wpA@-brUk#)VU`^eB(5{A>IwE6aAeq*yQ
zln#-IvHpRC8R7d0tECB0TR>(```rosD>d~$a?L-uXt-oZm4g7;R_2=V(@y8X9NS4?
zCdsplz-sKFF%~f(ul=_J7I*Zw162SD;Qbo|_#fIcF%#n_aA2yP4wS3!O8r<V@A1xg
zS#t;u_4^re@ViQ`vTO8J%8~b1Xf^>~Zx%=2Jy)v~oC5MDQ>96i+2=sW`#IB^qEXvU
z7-X@tvmDH2i~(E(c>801?sIH!$DN5KSU!unJ$&&<1unr%L)*sCZ;xbEFBT@ptm$IT
zw&$-u(R-SX7$loG4X@q^oJWL<V*bJ4b*R8w2joLT#RT2W+a1ikX4TC%_0Qkhr=X9e
z0KWKcOczxUQ*g4R#SLnq0E^iw3R0pMHxVusUd}A4xvD|#WwBLcV{4mKd|E5_D)P!!
zi!HBGvj(_ms6#}dlZzge*ng;>|JC>OKkR-eKwa8$!iE%iBm9%Fou=wDj+M^q{qp-m
zDB&RZu`-{i$a~@OYU$%uDuu*#=3eBHU8CeuA|&xq=_9HyiR;e2Nd0?}xiAmB%)*!H
zg)g&i=x&I~oBn}d+eu((hLhVwn7r*7KcO&wvorh|#r+?>=l2wR;Hze8_<$TY18De;
z7pRnBn$?C>;Ka*ZhyJS#{5ucAv+dPegz);*H!6s`YfLH#-5>IvR|2klH!(FoH{*>g
zCBlI5zO|Gi5ub&5-4};yv9u31<rC4IXGtH;w-uG7Z0`#aN2!7{5O6^+RDmTCKVc#p
zAf$gy;7r+Pzm6^PoTFOyAcUf@eJ2bvz-6iE2ZvN`n@e~eDR$j*6Q@ijl&;z#ljk&f
z=#iXsGPYQa8%{0<Nl}>K*@nN$k7AhR{s|o<_^ovtnN-A7zhzI^Xyj5UCp|HS%tJ*Q
zAPW2VANW-a1G1}Bm#kV*sUhwD>8dT=HU1TSNSK01WX>kM6t<AhEOd1y!Mc5`bTY(c
z2Q5EjAt7HG@piK9Bf~1FRa*+Btw@v!?gUPGF-7Nz%(wq<r7`?@0sX&cwvz^^Hn4Ar
z)XMo#DKj6IGzGg@6=%$yQwI2SbR{E5PLh*RXz*{LzPdb1CMIRkfU;;%x!02A;a#6v
zDW6&t3hHrW_fYEYp^_4O^{%`*v%EQwh|)Rt$x7*y6$*u<Y&98$Nf_M>luJU;+3Bq^
zW#sMD)-qC6JPh3i4J!GOxiIO+FaP1s-}<hZga9ibsarXd9sneD6Z&ozCqIjOXdcN>
zCEGZUK7fPh1Ho@P;(xetKlR4n{vDRK`d1WJuyecAC&#=RD$db1?Rt+XDiwRlZWYKe
zW{0~J)8-N@52=1{Ywc;+AD3Knw&Dvh*8GJyXR}${jAbY49&m@<G8>A1QQ2Uaby@Qu
z^u*l0cYP~YR&W&tGeKwJH(8#6!cuT@04ycGzdV$-v<1hnKylf+S*_D#lC-5V{)YET
z`P%5fmhK&#noBH4^oFidpXWah9U>*DojWzHn9*eZLK1;=%Bt>y6@fwXlq@me%LcxQ
zf1zGB%*x`*j0RtsSxs%eGES@j{fg&C!$~-<@r<ClO>&)%mdbs6>je{YPyMGj@Q*+U
z7XU-eYH}T`iFTJ?Y^I)hkBcQJv!~WXImAC**Kz{ie|W^Rm1LMRPqZJv#-=hK+7VvT
z;<|3PuF32YDr(!tlWaVwCH%&=ul--U6`0*pgMK8eBA%H9b@VMc&rIs!&Kv;W@<)s)
z?y~m>h)2a?KGg?E-jc!_^mm$&M~drw;(W{qfd{6{vsZ5P-RNb7SG>~%*Z$8f>}Nh8
z;9&xkq7?y}0UM8PBhIAO2xo?g@%^@NqffxogInO>mZtxGeewV)4UkOVmd&$#W*D>H
zUU@SM=7y)Q4toS=ajRM$ODmStrGV^BBqzZP@}qjRxu=1dCjUej=I4~^Y88p`5*~Su
z`82kggNx6CJ>U_&Nl<GP?}fpF&O6*5QmR|&mlf<S+ICzDHQ&O)cCH4pQs^9{_{!JL
z(sR3x^dq8&edGt^=7S7=l*U1mByRm$g_NxKiWVg9HL7g+-Z_7V@iO#(BJI|1cCO!1
zm2O@cQNdJ&L{nX?eUk%)IOvKACshg@LkG()nXoj^#w!%>DCFACy)BHD%^nLeBWqS}
z=hZdL5(wTu)1*W8OG|=UJ`WKV>E00oWz}SF+e#8?+n&d|m4Fsh+|i8Kr@Xbp1bK)*
z<Jid-Ay+MT(*l+VO$+Xl2{9Av>nP{?{oy-iPu3+Tyt{(q21#bvZ)d;E>~J|KlL%1_
zB|yligU&|nIBb3Lf{_l1Thn2}J_Q?IrNnm3G_;|YeJ`R5@5LQf-JTx1x0fA_VHp4O
zZU>gXBf<SqIS=}!^6?si>21@Xhe3$UlT`QN%-iHLjs8RJkMT7-#}Igw=~4cX4@>1D
z_FFT8t&ltSm>&t2z%(=b%h)Mm5Dk>BJKI7Onj}bL97QUb*P|~eABaOoz(GQ%(k@h&
zM=&Z)u<N8aFMCB|L-i_-EymeL>tOD20aTi>)2y0>(qQ_0slR)emMP&(aj4Z?aCCT{
z<P#h}%DyDUzA@sOr!tqM;^e%H;hYcJ4DNO}7hU<9#_@(X20uo@^gR;R6r0y5gPP}}
z5qPIt)1_Iehu5v6Ry_#^RXvZj2pJP}jVIHZ5=Dj`3m?>d*HSqkvs9kV43M?n@Ebcl
z6TELUiy+&v&Yh7;AScBVa=eD7MoTJ<x&Mwf`^$1AtJO+G&WUC;2<Ni#Zrc+<+61Sp
z688`x8HCh`(*JJ`d)czEQPZ!Gf@t*n(z6f?l-b?nCFo8esZV=;uV@l4S5i9aJL=0~
zi7=Q<{$FyKCP8q40F28|%e7r<G0FNEK;Hf6Q2jBK!>ZBsJ-2ZogAqnbr{iyg?4@J#
zW8PZS8-SQW%xi)r1aa$Rm7_aCfF7gm!*P_J8|9;=+_m_*c3XS7`k3eFWjCU>mbe)H
z2ItXKoP(^GO+s=q(mBMUo~D?4B`2?%@|?k*keNx$*c;ehQIbBGCivg52{_p7CHg{Z
z&?umn{Qy9?rSOSdIdJrQ$N<4EI4hrqsCG!VuOHRSE0^iG{6b+co2;xB?0CyMFpInG
zp4x=OQibT{!9W{PP4@KCDeX{8`J)FLHNASbp}tJ%E>-B0+xdLFKJ{fHoqH{KeL@%|
zZ`LH7oHl|_c>9I<IXEqk)EGj>36H;pm}m}t_k0B=_b!g*mWFQ^iO-;K&#u8N+eg~h
zzdIPArIAU1+*S4BAso%l(-x~D!dcLR<&{+o$I71qPX4UR@E^S|`8K^YOIL`>vco9d
zL?)s%2K{8WUeB4y%pU*A+9I9%1yFmrH1-Ej;sH^c3b_e~Gpjwg(U1C1#tC5=Nc(tJ
z&3T!a^we=n`Jm7PgH}N#0h<GOUAbUXOPPEyIx{oVMMIzM49VeP&c|tZgDBQ1Lm!fX
z64d7uH;X*;MA^H~Wi+6kL>bS37T!<s-nQG9rf`~v1=40|y<<1Qt<_ULqoy<i(%|o%
zc1IqG9AjQWp_yikP$9f@vz;LQCU4)9`|Zbs%A~fc2Dd4vLNTyV+jq*|*eZGrTh7M`
zZt4!q3)`%I77zpTEm=cKK_3d@nz@>GK@x?n(w^%|TGC>rnj&!a?f(n|yOPanr5N!<
zvwbhyiNQR(b2X3tYp?7deYO9$ugi<X(05sa^@y>t9@TvOBzDZuFd>E+kMwIJZA`qV
zCK`DmaJiJVR+|8EN#D$oM~n>9+>}nVbg|@MVuycR!TxKXzY}<T>U)S2f;;c->#~-o
zC+_&wOs==*TeA>fDl!1%YfIlBcz&^u>BZDsGGs3hlQ?&wohmDrg>b*_f&bXC@^I!o
zAs+S7i1*A`tZzo}1eby<D!9VKdUD9JvEt*WSe3drJr_Mpz;OS?R1xv3^z?SgyvZ@<
zoNZEz4NEY~^%PDcyX^bdbFL&il_da0(LR<b{atymIr7*pOAZA~#g8M3h47!81I%Ur
zjh?fBld5o#V9K%+t?iPGdeMOLF-t}B*0!DB?*0elNACW!vkB$-@3ERt@#S)dS2PVg
zxBaFWyLi^l%9oq2-Q;mS-O&jp@grmR(mf57%rN%#Y|s?MTvB-A=7Nc>uQZ|Ou_+}P
zw|ndAFB(IR6B`q|@=BKgk{PJFa7-ktRdq987}3jju;m6v+3_kl4;mf?302zK<Zo}G
zITP^af)s9C>sp||bs-vFKh%1_EB$_g8#kn_gjSn<zkK12Sn!R;;ieNXs3lMq3mc~B
zw4KRM5*v0+Az`ym!cPfaTXG|$ID5s{b*djS1kqelC3sy^Op@bmf@RUvm#8m(J7O({
z{XOMD4Cl482~+2~?=V7LZ8$Yl*&zo?Xed8@YBL84anNn=JWmUWI}1x?OZn=Ol<v?R
z|44PL28za350%O>=&p9$^XWl~0f}<6_Fi%HIxW#-$IocEOO@kwKOvk;GQ5XHy6tvm
zKRn);OMq0MM5-=%hRV$Iv_Txmt#6%jdO~;Q))QYg*6;<?X^B%<b4$oMqB{a^@`@4g
z+)B1XEpEogUM4w(st(Hb_Okl5IxlhLA96e&oWI{2@&PGvw|!|}_71j_*GMm4C~hB@
zsSbQJ;wF77DHR7PMjih8^mcprfQh)$J6R6AD9SZT>AanKF2P^>mhGk_FK!48W&T0`
z#G4yy&4@=ctNR0okuWNtd$>sRjyQAUPD&$fJs&wZEQ`L4*Nx19dtIJO^6FFG#p9pm
zKA4mKwHa^`<SPrd1jAdkgu=wK@7#J+qF&&nIk?ageOjFei6w-T>JG)pUz0SPR-LN>
z2=QPizM3Sln=1#niV4f0PaOwuG-5{&5U#^^?S5yJi4;IP$=BuZM#PCy*^^sSpD=r=
zq%1{oXTU`b+~emXCG$#1Smo(}$p*RojcrCrLC2#2(!_ZQnlRhh<{GP5Tcr~JWU+Jl
zj!!c>D#9~u|JztVrT}xiG)J!AZmC|BWfY**Dzl@&o;@;8Wim_y@y0ANIjc&@z^E<o
z1@PD>_JUL|I-^c6M7k=>wmw;x71hE$w>uG9YwAkJBWg61)~wY!Y6Tz2DG2gzJy7^2
zYC<DPf^ob4QyU13G7xefdLpxUam}yVNUr;0yDy8_nczFLY7UDk!541EO@*gdsG9FT
zesY0S$eq~g9~@^*i)!+#Xgr}3O6VbuI`hkkkhpxQ-__+rFMEOspm6@!GvGJ=2eEhm
z>LShdn4Xg!iRtA8bgtioSx=go!=){}-mwQc6cIMlM>5;^`vTS?dxd37$~h!LtsSIn
zZMN|wgP_EY)U5tn!nAEXX?++avrMAb6VjQ4MD~Xzq*2C_hb<qg956j@;JFYW8~~BM
zSB$N58ic7Nf@cF3`fqmg`#&s6M*ryt{+(UMdp)+8dS#v)=>z1{q0qDAHsw&8z^vKh
zVc?DYLF!(_u^D^DV>(_Ew3juPQswA)?k`pUHD})j%F6iFMnW5axjef8vN|vgKX@oo
z?7%bvQ67^M-=c5cNM86Zb6!G>3fPSENa+!8(e5d=GTkyuT55$79;i}#1ls8dTIZ1j
zR)sfl7>Je#c&nr@i5*hiQss3~cF6EU8EVV*%P*rGy*)aD$qf(n7l7lJ^2>L`0`M2&
z2`Dp5em+(~LN;Djrep)&w{Z<-|FD}_3c-5Q{MO?WVOs1U9@KTS0Sa5pbc(k8p}bT@
zQCUfT-tE)?7l}BeC=cjRT$5GDt(kf@;7fue0OcE-AyI3F6u9Sd%-~Z$9P;UaNtvMI
z%~0o{cJDOPJ6jKF0ZP+Yi78EJDu_7k==$X3t3Z11y1JraKIx8xIB34z(qgyEFcz=k
zccW&DsNA^zpwL9DYeF#nwrhiTo_@ncwA<&LU9g$0b*H3ipvHvJrv4HF-%P7e98%IY
zm${o<=%15J+~Z(D2KAG!D&+<Tz1}*A-{oqWjuYQXsuJsXX-D&!Da*fMNA?AIrcQ!j
z`HF^}4I#T@><=CiC(9*4?Q*~BKV7diF#|%5FH2$1j(a1eh66V<M(%Q#53E)m*}?dF
z!m>Zh+I-<6Ycs@&;c=i&`9XTO%7xF7gtM!kBkSoU{dq3WA-=2yjUZYX1kd!+qn}+N
zJKVig(%}Abt%_*(X%U0~TMhT&knI*!H<fOXt^&dHR{r)e#Pc?r9j>naTYK%<_PVpM
zR8-4Ujm#P=sFf^@UG*zyab;vW3*R}k55xs4IS=wgt1W=cnv%4Sx6|59*)9AKZo>hb
z1?~*($cVb^!i%!C5R+h*wkQdLdc#1nz4t4rGOX}!<=pD_3OyUUN(tAg5qq}5G_LL9
zkP(z^(Qy`eR;dA@nv$sCHw6+{551AX9(AP9_M3KfO#%xkNb3Ci_$oFuk>(R}e`dU3
z0oOJc)95}M<jX>swOvIxp4NBjelp2*re(L==aqY&c_IZ#gP;4(mcPOkflWRtKQ2^$
zLEWil-8XPgL~|v%t!db>U6*2_@ui;td3Q7x?x`qka<JaXscUQJy(l0yJUs4iQm=JM
zw%W4`EZc~;{v7_jQ3rM&I+pr5Vi#ci2{7!t<jEL3Tl%HwO=<Ee{(&n>4cT}FDvc(4
z)O24P5kkLI;kn)hJ-*A~(*C|qoi3XFt+hsPaRa42PI_l<Mu|Zhfgmg8GlN}<Ubb1T
znvb0v_9!aJI~K5lh1*(8^s>VQ3T^6_JA^8BKRGYL&=@os{!;SgZa@Rg+_N$HFHc1G
zxj-JTA5W}a@YD}=dFD{FB@fvpluNmDJXoBcwCEDrwo-NWVk80bX8s!AlcJ*{RYPW<
zRz5lMB!<^zJ`T-1u#~zy2S$S4@T;3Q@ftQ(2=YLk^GQ+4iK{mKN=lwWnmsvn&lN~*
z5Xb)Q`!96sXIe>>NKLeuiMEOP&&U}bj)2J*-kk1nO`62-V7zwp$}>B696e&jdD%2b
zX}3e3g*kSy2siiabEGsGvhCD9TvD~j)sHaw@|H;K(7sQZ%M_veI3Il<0wlb8a39TA
z;WG&JYQgEf-F>o#+Ro<;7aSqI12io;vJ20X0=uYhh+}GPnIS7}J_lWPD`rdkbsv8y
zkCk~Hhm<%^yKDT=Q@(C#-*W1~J^6;c!+X7JYwVU&kwWve;@J)E7knM)HG$tlqCIjC
zNd_I)n6kSam4j&HJ*`!G=Kf%7z^xo042eh8y|;6XpRLJZeK)vSclM<saeu7&=)n3C
zdBE8yFsJHcF9)mO6X#{EX0J`v?n+m#CE7--_FcIKhZb{OIet%C&ymj{aWug*BlN)B
z{I<2jn{F3nV|wHhzK1*xd_m%Li|$07t34NWq{fYU;&!Q)@%UF`rRAz;^|Zk0O0W_X
zM(bH9yy%ZVjF{+N5l0CGb&r<by=a~ovDu*8V(*u_J{MKX6%v=f>O_tSZ%5Dx7uoYB
z)Bwr7bZ3_?iM#%#zG&N&quS)g$S@Myy`~)9aMN%`y~>o|W2G;%#nkAIuBw~SojcFP
z;^pg}<QN59+<fqv;HZp9g@n}7^SNu|M#>7;$v9TIoaB{i(5El|8-OS98(V>Pikh(k
z4vxVMA;U5JtrMc@q$XF$_8>d5P8(i*G++FD#ag4T%;kg#n}SIC#l}`DTjfI^f?pax
z5EewLlN`>J_bA>!oPWX6LCt^yEpqUIm2Z=9C_R&2#8^pFT<(S(Kww|@m%cThYnaUW
zWy~0+!UXM@jZUSp_|s6z@#s3nIgeiTB?tYs(kCt)z<zlLJ;}{xVPU<<Zh_o{Qu+5q
z!2zZ14?&Nxe%o>)Bmmf`e=^#apJ+gcWdog;odc-5woJXZMUh4?1R@EP?~h)Ubu&UN
zFVdcs0_2sDFW&*37yS9NSVQArK*zr)s5FSgiMAPmkHDb}hf~~pxIysq%lpaqfzb2o
zLUaT8>GFBle9f=%PTv6GOi_i22WN^ZW%VLc>m?=BBl85pWhUN#LwDuZ71DSrv)XNf
zQi7i7A=t`^PzAXbn{82!gx#`H+!=lm&kLZKXGhPEVP41*Xbx8wb~Rf}nkc*y(Oh96
z3;7PmJ@L`vF@4K$Xb=E~frr2BbR7u?!c;oCKfBu6)0Zk5eGwbRbi1-KuL0hGfQsUB
z%O(keyN+&^1K)>B?5ZRzz?I>ds`T&t2Z%Au{)<y=3?G`IHrH_ScHu`aGn(1=bt#`N
z-vq&wHg-EFAdTkCy^i>J1QYFc^aML)=N931>B}Fu-mG+EcNx1YM=8}i;3<)Cb^njX
ztTTaq4Pmp0sg>+ktCjIE=*e21ibGdN#P;87Og2^uLKMQF(d(A)*YA@uX8oM?ip(sp
zqaZFh3lW)~MF_yN$WFPg5U*_-glN(YSAA&%Y&sc=hlNKA#4?Ukuc^uDwjBV-VDa@F
zJLRIi*r1m-f$AV@MKcV#`>AZ#Wc6AzE|hXep#CJL1g}y%_n_lVb*GlZp4~=YuZ{uM
zvz^2Ug#fw)kq+bwX|fl#_o*D;?cH%mabn@ax&_6HK=It!NQ_>-plKJZ(#l~{fQ3PE
zN?orHr57PM!_yN1@hPZ;;I~7sRHurMa!6;$g^EUs4V^80G&Zi!dSKZH4Y6K0zD>M~
zbm-z~$}yrverN#^;#`r#dbtM?&QQG^pn|24I0JP-?kC*Ptgv~Li6a8ea?mHkGmjtV
z`~I5DA<70_8#ojGaz_`1@`J^zUUK=N#hc>SfXWSOp=>2pUItnb&{rTvAV6*p#rM1C
z%%E*fYPGXf=v0E}&xY%PJ3vjC#Pzhc2O&7n>FNzxU6b<<q8wA_#IJgu1o&!+`JUl|
ziGj<%_)+hS@K-y!$O#eKnN=r%s<n7XZE+x<$hDmXlO{xPCepmGZbC=Pe|FFQfR|Wb
z5~r}oa97uImEGB(nd(#_TLR=3-$*ZCbpiLKHxbg^o{QKpCPxPkt?5*-`L1im{x4fA
z!|d5UxOH!Oq>VVZYu-!zV8aSH1${=W=6g~%aXDqTBcO+7AJ_#8;B%DAv3M1lVL_of
z64K0YkYW0qe98$!qgw2#O0n}}V{Zz=B)AWr<jHe*tP(Sa^@UVzI;k0aIqP$IRUdM5
zifQtL3N~!}yyy0;E0-N{a2D?(v&<gPMYQIEt%-Rk0X)x*Tn9Pt?dKe92xHFto;nm?
z5>LqC5z8jfD2i<Qm^%=aC1Fsxn|HdKdu;Sa9(gQmS_9rv7RG_h``V?!?=4hD7L&|J
zK;{2V4DsKpi{;pim3gzGFB50XRB>xQut?cxkWJ;JahuYeuw2iDw(+@mHcZexVzO`e
zwpQtY$Y1xqIHzD!I7=NMkn>?lvS;@f%TVvO`UQffT(m%f`>d0J4MaEbUXR~pEu03M
ziDAv$>jJ!vW(&oLlMUlOSY+QM+))crkmH6tX`Mmg_zH3)2K>0s??3|C&*dh9<|3&G
zsllL;JQgSwfNZPD`n`4MhjYve{#i^HrgwvT^2f#Ocic8$zoAq*t;eRp#NUer=-&NM
z-VZ6Sw>+tJ+n!DH5B4u1jU@{1*bI^%tl`kdtMM+CRp8H0(Oo}nX#aq<k%h?EP`9Tm
z<oECn&?sE2Fu|9EFvn-l`Are!A#1B7Re3&$U=U)hrA3xtY_B$K?bas9rK4GV@HY3E
z7pl0qrjoXv-R8G+V)^-Y`flBNEERVolhUq^gmGuTwV_E?b`*q-CCTtV9K!>T2FrAi
znyy6u#l*+sbo_1{nqERRvxK<(%1*ukV$KIpC@TPBE;(`cTusin1mN8P5shE^&<;Om
zmkd!1Zz+=~;I30=@%fl6&tm>qFv9OyGnOounQ38c0(@ha<JnRY%3Uu=M-gKQPAt!T
zy=K+?Xn}U{P)DkX#sZ%bWYY9-NuHC_ceiyqE6$DCt=I?y2=mRsxz7@WnCx6iMKB+8
zOTvH{Gk&KIdUkF@xx+wpE6Mj5Y{e}^@mrKKVxVz^*QeRBLRQHAekN2z$YV3k@>bBD
z3zD<7T;O&5E)^F$qc)kL{@yXr!}&6MmD7THr$Ob_6uNYNt?|e)oGz78B_OoZ1_g1*
zq-l_I-(#^q+k=1AUqAT(|35u1e>kfqk)DI!2jI=$jA&<P_huL_ZA$-f;{Dzy)>~L%
zJ2v~6v*!#le|MgxgjgVMgrw(Pve2fUHo>4OnW`zCsW!`jvuKBVcWDk?c?>IZE@RX3
z4J(iEDEevng!-11;Duox8My##>(HQieuHk7_eU{@De9>Au%jA2F|M!TwrC*Bp_zcU
z&uSu_(f>q5wup~yQD_0=R`PR(Jm=JMM`}+L`HE)~UKrMZj5Bd3k_2(Oj_4aTEZLo_
z(k^?%>e+Z?=5Y@GS05_QARk2m^NfQCSBHU(mE>*eV=+ht2ud6nJg?g_PV}v}e;J|(
zbqFq%r=2Y{@0mZV*#46H+GhF7Fi?{QZrH^=rl>~cX7%<xmJllQzALxz{F4=H>hWw+
zeo#BWs9hE9<D{zqi+y1?>Tl0}s6Dy;nyD;zYwk|JSXgjFfe#5VI)J!HH&;j5P%*TB
zT!vqa74x=x-iwkqf&k|bZveoHjms@l5%5YE<WG{}Z$)o15WNw3UtgDTL;)*c1&B=@
zatG`JwqPZMB>d4bR(?2}&$=1N$e@dLffevyF$LD<&-Y;-w%TcKN)svIO-C=fXxtc1
zbs^W-bEOhFh2;B8`;cuKw|KE`jC^)+6w3_&{zHkQSVc{3_W73jk~o;Ya=Rfo2+=6$
z%cNhaK?BZ*lkgdf8i(H~0|4py=}|lr-#z#P;M*cleQp(n!qmSM68e!rt4L(^Om{EF
z-9iwti}*bx{=g~K7n*Bjqd|MQ6V5aJQR=@2Y;8VpavFE6;i(|+08Y`FC*M7Dz5ozz
zjD!Goigd4&(|!k&jyg#KzgKUevxgD!h^naJcdaF_u_YD0l4oZHx!&52NztCuHOBHV
zN<MG2Ok_(69>9h+KsqWN>(4Du2{}{<DetQ7C?*%O?33iP6a`ulc01UFASEeL+@}d9
zy_kk}v=e(%(H)1oJ#p`~gaw=k^@(Atr9GF<&C(kleJ8R6`@nXgPO<&X_mJ}*m%Rb|
zK92qJ_=1r#F8!^MM<mhGk4X@)fy;CRJ}^h+SCJ(oF5m<!`r?-bHMnDVrbK^S^KDi1
zt*$pyTB?PBkIxE&yYk_~M|)P<(b^0ay7XlyZ{4wae_7KS4>Qeb6d$?1XgpXG8e>Hm
zj(c=3Km28}p5scaF07QoS_=tjD3cYUw@ILfGEBq!kEQ74+o=IBnLVd2LH!Vq^0qBX
zLL)Bu$6*I-1G&c~*&*(pumg6%Y$3>DJX_dR*GnZCJCiv?BYQ!t+&kDQt&rI+8p9Bz
z)ebKd&NGZ|a>;C2aJ_wZQ;#W}mCM!KWAVbvVwH)E-SFw!M#=l+l!dqybt|Dq`3~}}
zF++IWCyti|S!h!d0`ywa>7tkOqI;#Xh9hJf4@$d>z@R9a{lQBeE>Ew;Dq_U9%r{jJ
zT^>_vV4H0+*M!E~rD&($-{s(PV7f{f$?N4fhEclM{^|~#6=p13V5ZwL@0WS?_znSy
z>$qW}SH?8b0pvl{s!w{^CA&FWy$y17EK}%CrqS8kD)~V=WIT$mN<Xpb=vOQ>4k^0b
zi7}?vbSzuguiG(dlgtsdG^7k(JlLyu|IN5Gzu0Hm?c)Y|PES(K?`&E+N#T{(+m<+r
zSF5&geJZz&yZYUToeQsk=r~b*;T{?(;!HgnKXvw^QkV^-LA!PDDrJs=np!&}K*uZ9
zU1lk~$?~AqE6qr0#+HBWWhN0=%V=|V2jC+eWI&}xaC2hBDm@O>P#tt|=u+115`}NV
zL8huL4#DWdu6xt+G#vJ;CyolgIo1tv_sA5YqjuiuSy|U{@j7uLNQ&K>9b^?MY7@B@
z+dkkVy$4dgOm3<-_RNJywrqj3UI7IOr{Z^Rn=QB(NpMY!GMV67?2yOrmUZS;?m2hv
zewC+IwMg>Zv6DyKusPgp$cqbh7++TTp&iPP#ltk~(Oll@*Nt2?TB=9)gJ8s3N8-SI
zV1XhlFk@TNpN}-Ujk6F3-`!f{>(J@;dvSkol}}uvz=seD4ZZoD;X;8H#B1ciN`!Sp
zw+Z2uFUIv*gf17fyhBqsX>d~CvzWxKo#XL_Cuay+@w7ri{$u`WN!-ItZ-%Uk5=!VV
z5^qW!fI%|}N~LwR&Wy+SgO}b~1PA8R-5{ZW|Mw|HJYha>vZBG+5s#nnBtB~(ijcRk
zbp<X>E#%C2Za?}A@MDE1ZFSw&%jK0l;<bxaE09$<O-zp0P7X{2lyhT8K~U4#%H}^d
zru>1R`qPU4A1b$QR`e4lt3aZE3V1j>i^%!A8$Y#|;fM&+WR(G-N=!JyABQUyh{J~9
zEOuG_mgzPX9AMO=EV=g_R^$f5wUHV5%3Olm_gThXD@oANT)D)O!LAXA-L2kHt7Hp^
zqTk`PwV+;_C#%Y_!-JLn;0Q7vVzOJzvu>Pd1Ne?e%I2B+$7}t%LS_wclFSoc_upK=
zu|MW7DSpoI$3b%EHW%~;iWG4mRG6ilYuyF?@elBvWE2y32How}<UV%3!Rx8yx4Snb
zx9WD5ugxWSly2O9*-dSBx6SVA&x;#Pf#_R4IJJ(gQg>|M{q4jNi}4o;nlyb><lwmn
zGvF6Cwe`o*N#Uxe#5O>0(n3~fk}S=_{3n&-w=q`Or>pEH4*N!6_&<#l85P1+UI%~v
z95e(yn2~jov}xxY8cScH_zM2=h5mYr{Ppn$6Vfg~@>jkQ16>c8kO0f+iQ5Q7_T6a;
zHI7-AplO0>3$;8A`liBYzl5xSBhD0z>%WWV*yMC@YcchF-#tNYDoTmB?r8FwY1{tZ
z&gNV83ws@#B1G!wA&NLWULv`i_yBhO0WtJTA65eaFNrn2rnXqjc2dZeHk=`Fk($=W
z6>Bn7wyk?)>~eo+6a#gcxoKXP-?`pR+~a!PXd~d^*$`yCQn7r}q@Qpdr3YD*t#`2L
z@%w>5abt)6S$Af+3N}@$_xgYk#1!nRt8cAIJmDDS1KjWFHB;Kcn<w=`m#>P!S;Kh}
zPkZ=22p-Dgo6vYL;TG&%W6$x(&DF(RzX-cr@mQtQ8#$#=cbq?|mxFQ2o|cz%B_CFG
zO7KO5`{x!XklXpTD(zaaz(^2ETj_CB1h3!f=E#R7cx_dwXP&Tdx%C07xDyi<*{e+h
z2so<?<MNy{X=i>f=3wo8tM%SC^Y@P5-OXWpPVy+<pkQNvzM^>|aJDtHwM}~jZdQNN
zy>XmS^@X~RRQ9d>D%V_Df>vN;FxvS7L04!X#z2SiJ%q{Xc7@3a2Wi~aUbn?M`Dv|2
z_(I7RS6R=-HYettOnO?t^Tx6mu^VB9(4LqhBt(dor(jL*uRES#lDJ84+}<qn(AzcM
zX(YG^p{_*kuQr8$9XPO#i8eA@Df=3W-{m3hewfXpd(LrTvOBFR(6cCeGqWI<c?ptV
zye&7oy55IQeb=PJE0NlM_1lkbw4C+5ewY3&F>P$5W8Sd{743I`;@z@>`DCRVHwz;P
zGq4d^jw3iv>-O(h+V5+QlfSi`$tMSAF_xYi4R0U5Vj1~Z?v(1ND=hF1cB9STDCk^$
zRfIJzKF=H$lHj|$`$VufyFwCo9J6K%=5LUA90Xv7sGEBXY!OP$3(BqnDWi9=M>c5m
zn4Je%Z&}dyzxWV7MX0~?g`_>$J`z^Bk6HY!daHoDdU=xRH(qqWa*mGW7*DrIj1y9S
z?igiPJ&~_Z_v(ngj<LyOxy=<<Shlr*u~EUkjr!l-l6AXUEh~9<ARvb)b@Z_~hh#PO
z9<%7%<J~VXQa&!uyCgy#KbFC6A;h>|jsm>GS9;OknxARu;#??j<L&_F!?E4D_<aU`
z8}(k<cxz{Ki5a^sX`S<mDlWc0JJajbmq17ulZG#v`3q1#a#)iOSDT3Y2Rjy?Gmp8|
zy;mwXp51PPzR$I$i?F}Y`GoF_iGOVp`KtfHrm@OjygK%LpHqol4Ng*H`H1t`Y)3me
zGeYe*SpI%^wqm(l50vSU`p}hdFF(3@UrOH$dgHOajoGGpp9}uxF9PqN1JeUAj(xe;
z^aeJ%ReGcK316OM1|kl;9i<E;CSGW8e>zmv`>!HS{@wTgj9>xLGX}!JlZCYge(ar<
z=IivaeJ&yKQyekcMkuR`Uwj{)t6}e?P=lpuBB_HhBOr~7z^A^teJ&eWR6LhU{lAr~
z71dmJVHt;4eCMYI=SeOpY?H8O#Q_A1A!7fu?^f9|a!Jf3lnUUqz<e<K_21W+*Y+T&
z$sO~ZFHcg*mGk8L8_1cm`;pAnu!kUAGI5c8wQ!zvhd2R1O?E`ZmnV6I#=yYlbt~4a
zY&WGWalbj2mF-(uRMRT<sn^hBi}?&jR|iJka<VM54ldLQ96j9I2$nA2tWb(@z-*S0
z^KIw)%|Y28fLMNq=g1l`Rb#bwpKUegR=%fRHhdswMCT>(IFi*<^HH@`zz$>7Az!3u
z_W_cP(C19EjI+2l7}xa)qJAcmM)9jfX_uA<0rEFapexRA_aK+xMeC9Q4I;ES2<1%K
z-EH^hQkWUQs>kx|4(i_`vUQP7l0G?}k+zI-;}B_sH$XgLJQ&pi5TY^qqQc((_Y5z;
za}F9lD!aOfw%T;y?O?X*c@Qh(l`CV+C5gbCf;$~XNQedJr)0$jai}|WkS=Qm7-p3O
ziH9q82XVC{tUu+-oIh{4j2=Jc0TKtCV4;ZnC59J278opcD-pb^E0dS*wDY#0d@mx~
zML-p$ibBPq)OL23b%KDzO&V}8AVKJehGM9Fe=ZF~Q^0<UzdfK*qWcOv`{b1I&LNa_
zLaZ~P?yTR{3xSF|8wIx@XRLRxv|*lm2KlzmSl)uD6ZF4p3Wsmq>bF$&mxspEEAiMp
z5Rkprs-;rcZ>;2ipv>t!*Ap&DRs81Ew&(nADK!~~t|r#-*9^2D=qv@9g<9vZGRz#-
zhGs67kX)H00`QnHKLD9Yt|s>Q;Lj{xOrebX*4bGC8EDEsTL%^D6MOPJ6-243D#T6a
zeTt|3{G-Qb_K7jFRC*@%MeqZiWp>0h8!{EtePHN$4`1M8!R}D8d&tHzSITH8&OTrU
zDT3VEi^)FP#ZezHW?r7n)hW@Nv2y~m1KAYmfmc&B&g}KBNhks#K!obsdR#)W^WG$0
z43`e6il0On!ncJ?zP_f-pEX^PvQ(pthv<-a4a$~a0siBhT8&V1m4lBas>ITsiq;FG
zIKHFfbr-l^)8Cyiaaq;#PEfr6Is?JzFB2?b<2(roEe5#DOirC^mnI3KgF;4&%bJ&t
zOAj6Tiw<D?g)o23=4zDKj8C#xeB7Lfghz1(wk}2lF82W`0(CBcI;jk*OxP7TUCl7_
z6Up^eU3z>FGxoZ!7c}S;&z<u#Lz#ZOP?7HAuDjlsA!06Sc`t15jY#5n4NTJAcj{AM
z#)WNYke;Ioh!It(GZqyT^)8U%_Ot?tq$GtW4pcj;Ju+Xe(k8PvEFit-`GC%u#cb2d
z`k2F~(t8yT$JN>e3tI4S4yoz1K|--juA;4Nt~cYoFLO@o(srEO+P#8_J7EdA4=Ktb
zJM*R;4<CiaklDQWQCi+sopKmbfP_7}VnBL;ljC|jWs6Z;fMvLg>1aZ}CX4IE3G_lO
z#52vz1-bjcu0od(;gS#Np`?-Rt0b=Q>UVw(*W$0qrc8BmsYMc#-QyK9yd|~+RWQNv
zf;~!JDO|Vo9^Y1ZH4P;h^-Hl=Tp+2(BgI&%Cs<uqHOfMixl5;B6KiCgTTnbHYb1Uw
zOQbzECW9|b03~?H9Ks$xnISsXz<)Jv6CJN+d1E5Z$!kl5)tjm4NV?$82|-1B?J!EY
zjGlP`KMLaIJ|%=x=gb&&*IRd@m>)bhViuTvh%2MVk87fr!*<XBTDCofFK~@|0+$iM
z)~_n4d)`5yK3J5*>z-ta+y^kWL8q_f9m+WZH(P)X-gqzlq`{xplK`RG4vi*U;rg<`
zI;#|EK^Gm|5;r*uw0mwlq#s0q947Bu(zw2N`-78O5@?yH8Zqs_{=yQ;&63%>)n$;o
z%qrbs2)1Q2oaIX^iTC36h*usT(0eu19fs=X-YA9iUA{lzee=31@4RWRHW5OB>T@5W
z6}S)9NFAb48k8D|7b~pt%k+XlN)k~$@KQ^Ud+O-W`em$w0$A|PApOuYse?RqcwPHV
zuN|jp1GK}Y(i%%uR0(a$;&^ZuOF<xeTS1DjABp$HHde8Vw*UZo*n(qEC~+X98pVU(
z)Ge0WKCn=idif-1+fly)nSuPML(e!ABe^rJbG^vw1p|yL-FFr`+lL_SMJgE@6deu{
zq=-GtDk#HEJRnYD(WbU`|1Jf#DIk|a*-na-T}xQmd74L?mH+b9M6H)PYp0^@**&gu
zm}|O^>x|tFPknMJ2gRB)P$)y`k6|T3x`rahu38<JGdkG#(nVL`h1qsU0ikGRq70{<
zdfA@i<jb26DW04PH2dvwafgK3TI!v9UOxQ9a4>?^t7oW*c=d8f4Ymgbn?nthPR*f3
zzdiv=id`%$eq(4uLf@FrDk5GEJS{?U!&Eeec4$7jQ2Z9TCBWZ@69%!fJsud<Kzr4R
z6-Soc<n#+O>H@D77R%2?em<H|A2??7!Q%h0_vL|5uI>NN*olf}%1-tf5gBV_q_Hn!
z7b@A8Y>A?Tlxpk@A!#gQAEgLMi)@iFmWoKBEYYb*NPhR|oKEMQ&Z%?W^ZwrRe&7BW
zo^76Ip8I+3>%Q*m`dpt+c%rYLamq6#SL^L-&K82u1woSkSn1=&vU`C)tdY<0z}dzL
zGI$SlFa!{o<u2XWYvHuL<d71>74nVYX@k;16|<Z)X@htIBn8<+x;Kg7+~g>PpsYDv
zM09%kf@qz7ct-ToFqtcrS)iX|<Zt+)>L*zW<`;WNr?hB@b_d&_{mD*!%^Tm;1e;ej
zCp<cGPNg?zS5Tn7ScgA&&*Z)0AEuSPvEa*PuX3mqB#0&uqF);!FK@B4DQUn6;-R+c
zwK3O?LMF;A`83FP>h)E%Fi^v`7iG~;V0OM(@S}|NAaP>x71nGo@_S80jt@;eWrM(>
zAsoYM=5Y*w@Y}jG;l&w?`H{|<Ten;+qRlLaoruT)I)9ZdMK_1idu1A>a}u;@V+r!j
z8-xbd!odDB2RRy)V^l268V>mHD7*aV;v;PhyT$52>BFF)`**yQKidAO=A{e2jY^bM
zhoH&vBHf(QIh$afFh_F6<VF~4?aEG7umVv0+kUv09xOX%%(u4j^u@0;!TF$rBE!T1
zPTB1Z8)S^ts4YC04yEJi0qjE$riL7}#epPTzNRjaS`~v4fv&dcKK^nq;}uV_D%vD<
z3HWa&rqjlHig9{0BS$DhUGLjHjAc5wWBR&lxMQYtYYW)058NKOQ!CnN-yZHP3vnml
z)(ae;B`pnL^)c2-vI{2FAt)6IzLPKcPVn!Y0nWfC-DmP*Z)fuW(M901+&dtvbFmst
zqphbWL9=V<hq}zxDpqrZa3a(|SFWYO=Z?Yw_JyLyfmBD<6pUb>7&QMV7yiY4Utq70
zTe^h<`67BjPOg)hx`{!#*{LkL=tnFz5-=Hwo4}1*M-%;LR*-JLsYLp=V2kI0d^1}T
zB*X8a%V%wGeh5u~a>)87t1G0wIT)xl;Nix|`rr;?6>YkOi)J#B`Tl`it_|>I2({(r
zFg~0_I5$X$)a4v`7D=B3SK{PzU(fkA8i+?1*Dm-s7`TLlYr|m@7^TSuNe#|D!3Cmz
z&FGgZ+d-v6xdXrD;4EXJ+&gog{=gSq@5f~;RdMv^PNm_Ln`{j6M_r#I?AkW&%B5^7
z%@^#Tuh?OFXb7*#aSVpQH9uEYb06H7#;7Ji(?mFbXtf&h8QOsui^@MIcF;9_kMf%u
zP$KGz)#5>kPHNUDx8iC+3GJ5>tT9)+lX-yIOo1gfaS8gFvQZLheNk60Z*1whdx>KW
z2{PIklgeu!Y?_*NbC_(orP(Mbckq3{)A;q^KEt%dYgGlI)z`Sg?k#QyY9Epyq#o`?
z9tNHIrRWaZ!#&0-2KMPLZ`o>8JLo>>s3+?P@8G1(2q+pnklLRq@g`TY5)E^0HG8A3
zL^8*Uci;;yUCoF9vNgKmWXM)lLXcf|RLl3KeXxa({Oi@hrt=inz#!r(7qr(kKa1x(
zwkw#ajx*m;LzcdHE`|Atdi!$}1k92O`=+{?VZxyL@9=CMjy`JVdSp*OvG97=m9e|$
zn4gaWU=5r5ORFj7O?F{29(&3kBHwf$c?JZE*mO2;I1q;%y=o@q%^@1E`07B(gaoX=
zzq>cr3a7s|ax7#p@)G#6^R-B%ANTunY&zavf~Fm7(u#rdQ0E5ZTdkPuuS6(3r#>`|
zEJFy_P7Jr$Q}s)^A>GlG0lTJ6omXdeSDXd1z-@j!10p%Z!kE{aMo&uIMkHV%k9K)t
z^!(0EgR_XXI$au}Sw7Egc&HaYF=&0<N;5zBz(LE-HUcM3)_MlVP+R*5wM%43_MUs!
zuKsxji8oW$-9Uiw?khtY$Cr4on7Zu^PK#u7a7SeU?i|<rRx?eS+)~SH7*x2lV2Opp
zE-YnV_Y*mC62I^D!&A*sBIko!vctqHQ~O&)czg5v_7T#$kIbG1KT7iuKsMbvnvBRD
zXVJOvUK5{%h1_fFO>Kg_=1%He_7s*%b7xSPk;liBMFd+EN8J&}or4DwS1Gjerclrk
znL$NsRhm?)$Ji9x`~*_gAo!p?iHG`rFxWO_{I=URWuG&reXk)<61uN&Wuo!Hk+z*W
z58~wlm8tYAb7xkGw2Fk@w*1iJt`d26<H=eF(4H3uwkI|Z0MG(k$@qq}ns-+%SR`n-
z_dZoh#5``G<a(ak&H2=^i|h;zU530hr0*V`<jmt5(h)tqW^jDx0UX2eIcCwK9ktpv
zX`(w5CCpwTx!y~PWyW@13{VmZQ`spqAJ^8ODQiA_B~~m^nPFNk$zmBQAL)<D*;ZjV
z?Q&%F`Ya^Nq#F^)P}=TKeTdn;UT|2BXua1VF@Xc-twG!aa+wy9l0tZ>e}knTgU-o8
zJ`bKCvg$=qx-D~vWGv(vQoF5Nq^X4gMSgfiDs}5DfM+p~D!R8>J)CB2Q87EwP~x9;
zYOhtTQzvGF&2z7Z=TuxS$hRfMp`Rbj^W?xoU6nOao|-cAoFnF!?E1(xx7Ki#1WVBB
z9ZntO><K38`l(gaZ#}zY&ua-<)}eQgnEmtoV9Fvk+ep+XpG<8;_D5Qkk&bf!5{J_n
zd!NI72XMNVI$wGHRx{DK7VGSL<u%7}L<2ziDPDi*$v<`cT#wD*Glt{0e3hnln&TMA
zZQYx_g-%BEBVYP?stVs-Y?0*0LzHV(v3og<pG+F1yxNg)?Z^~w?=Cp3^6go{qaBRx
z<0jbP{JZXJq$t!5WNUtUD8A~w=Qd?lQ^wtm@p@0yH}SH>hAE^!ZQS!%Y5o=EROwWv
zFz*eCcFqzT30jB4RlHj3!pIh-;<5V4$-%7Psnd+UxPz`q%0oR`*XPC4*t@6q5_sQ}
zub+B^J{ev~Q{4AR8=fe4z&rUI7TRY!pfSox8glCNJ4jn!aPAbf!M4AC;*`v<{-k*O
zL~j6_g65jw2G9x4QFK>{>($b?)%4GApv~6<9RuC>l-;f4!V^Q=Qw{lqqi?aUCKztY
zz)gx)y*G=DhgQuMyx7{2lqnE#rc0>SrHySYpZ0MK$=u_>T!NRNwR}A#VzD+;<4z%c
zTkZt+(B71?0wSAP@P+-Qhp<ED3<nln&%IYJLgN^!uM4<~D@RA0A9c<?%^;VVoc0Hh
z;6KPx{hVp)zPJCNS+<6-eFnGV(!>D+_S@XhLBd@f%?#Ye_;a;LlMV)}F+*EC*4_}Z
zSd>d?bm!)f*^ub*PBPjxqsK=XQ9U6+gQ(o!Z;RJlwWie1w0y!=xMFi3{6xD+Z<yq~
zQ83HFhof%`-@j{ASa_E6CQ|lgI;7!!x0=uW7}x4U<7TIGn%WZXxz~-#M%*H@<cY7U
zibW=?UOI_m^f(r_DVBg!G0|Zbo;2L#;iM7Wz3;pNJ>4T0W3tXUHgpaw$u#@O4I9`c
z7K!-d`?y_G%i$_`P>dYh0Z_y*Z4}9%c6Vh}766aQJiRMrRv$C`Kj#lVrwC_22+zRr
zHL)lwlge!bjzLneNpA*w9J=Vd0vq(;QUC&BEEMfh>|+C4oqe{}ZLpjbK$$1CW~l(@
z!Ezs}tkaLHI!tOvw=eofze-;~U+|YCmu>;^3g9mZ{Q-XX^HJ?DFPnD^t9GMv$TZG{
zG*j}L?!~4c=R_wXwe4f6-M5?<wpZb4dcP*EAyvt_Aa6!gI@b}QVz;9R2I$nz6pE%K
zbIrjTgqu(3&=hxWN1S?_u8^LHXV3<OP2B_>-C@Ag1k|N|vq~u%>Kgkp2r%D(y-mYZ
z+{Vo<i1tu^ysSmL&Eb$vb1`GySJ@}_Hs`4p+~Zu0sz96zyGYq+Dr^20T+czc&#lix
zPlAgdP(lHSB>NQFOCBV3ez^*D$Qu1>`cMqWc8hjipT+)MCid$m_&>h>Ga|N!{MPr;
zv+R`3o1*<Ka~vr-{#9=<2}ZFV_W;8zE4d8;z^^PA%j}XNlW+{8pjZiRkE8cMQTM`Z
z2m!^MV4WtGV4{y<mAjh3q9Jm8npS>Y$VB=;>b9+Bh~w_LV|C$M!^6#pgRA(BJj`R1
zm0n`3+XJQdyOVUd)FyQ;0;d}UEsl7P;~8ARywiZ2Qm6Hhwu0YAhCeb)&aJpkbXUy@
zfts6JwZ-8uons7#x%IkOYA`p2(Z?j-J`0m`*S5(t49A$@R#P=;>ETp(|L+n+tRis1
zZ*NV&ivZ=mVG_*2Z&Q(qpW&PHffE^JP8j3efXYqEm~M@SLzzW>AZNj`lrc%2Y$sNn
z`D%JvIb^>r<-)uh2La&#e@kTTL(Qd-BjzbUj~Krap)s(S>91Og3`7baqM<@f*X!Iq
zP{g{w9tdcOgrM|dRT96AbojTdSD;{m1y2gCLc$QAmy7%!EbU*}9^Q-Jf6N%p9CxOm
zpeV@v2M-n)HDz7*jpt;{w{f2|j^=%quECI|>6VS(apKQHmeo|cP&+0K+}tPJpPb<o
z%29Kds5*U6oWzqv$<B@nmmZnP*&l3fZsIHYD3joAtcS--)72zVV(yHam|$<7*&l3D
zt%gELRB?cPTdpVb!R?s0TqmU2IK%B2N8MVwBywqAm!|<#1?(Z*&oDc6H3)hG|K0NZ
z%Wiop*emxlnvv+=#^SMndln?+|0h2`!(4kKx0Ux=GQ^ujB<N^L6dv3-A@N|%02*Z1
z@(Ds|zkOX&67kUKoc;UhWg?BPS#%20au$&I_qOXfNP4Tq=<_x(s8E8;gAPRMNL#Zy
z5T)y%qn9D+IO$aOX~)6nO0w=~=V%Ar;j_I-B6EdDuBu*z;`~?3X+4`QR9#sS3-8T+
zJ;we<hZ($bzuWt%mcf(eHchr{)pLY96JvT>bN?*SaKdF|fpXGbqg^klHTU(>cy!W~
z)VM*Si(f1ub5AY*E=U^?iQoC@QvSg}bt7{Z|1LpcKs@9hys`|*`SZ{8ooUT!CDO-{
zbPX-~zfmIb3uqSLL;%`*fM&t}4s82x%b%KR-7+%NHUtW;UZdNuanm-$dL%~2qqeW*
zs~r=oZ+SJXJg)bWU#Y;rJ`;IN=x_)9jV-(u+WX4-DTI3MU`;OG4z!|JE}&pl`D*Bi
z#v*{0;n<k9h0CPr&8UqVYj9Sw$V0D;tfGA6d2B~7UNeo_dvBO>Y<I5zmZaC_JLSFX
zw-Ym$Ce$yVBZU*00HagkwTO7R-ZL+zYPi6<`xcK|l}d}<PiPX?c+bGB#LkH2FK*Ks
zMaOL5+FchWc!zYS(2~K?AW@F%7Lm@>efAG^4+__jwSjZO5XoOo$R~@^{F(lZYNN8k
z?YUus`(!sNJg&TGnqs6W@9Vwg$icBabM}PIoWScf#&uy5ch&|mRnn&rot(E?+uzq^
z5s^XCNr!l>3cIk$YdzQHHpn5>c~w<mgS=xP7fz=%Ys<~t<NPWtB-)_$6eX@cL&%ZS
z*%W4$WO!&${W=qQ<f==B+(r76dNCvG`bsXX*5H$%6}WT8dnzA35L0<{wVG%47If4p
zCSietwT>0HnYbU7Do<kAZ5l5d6b!I=RFEUztlcN?Y8~3t(sco*7`>qs3t|2D^}gPx
zy1*Tim2BmYq`4}`t&8%R$U(n#Yer2o%@9}b5<aM;k))|L)^EMm(?`;EpVKL)q~657
zJr$K{sAys{ku@;VeAnGv7Ka?=y6E&rmDfDe(z)PX$|S754!=2<GLa>rKiq9f=*da4
zYp$v896ZCa@7|n(w;eTEBcfxEE7=e`18cpMth6`6s$_~1uz%@<aUs)#Vy*o^@4|2~
zF+_q^vBkgTn3kWWrqEh0owj|q#gm*UutespJh_KK(+s1^aM*TRF5%NoTq3jl$>ti!
zvHbK$HCI!%9%^oCyOo>yggoWwL@R=0;Jz))fzTC7YV}=Yx+PzYp7Nx*X79X^9%$)=
zf6~Z<hV9%pWp4tAXyZI`0$BZ&UdImgDCF`?iDafC5ZTq|0!xpU!&YgcN?+%)+@NE6
zYw)hs75~7b)<&7jn2+AHGE}Hn%j8^c2ZJzH<j`QQ%Z0()yuOXiGKMy~F$1}gI0leL
zQeob9FQy9(JGGHeI+PEu*8<EVh5^U3721YieFfWpz@m#XT(hPyoJP?nS!F`TD~b!4
z^@_JK%_5TjTK@dc4$A-L<A1IX{#c=9`YaJorz5i0=uu3!IU2WKlsdT7l_0lh>m7=Z
zz1AV6GgeqB96)Sb8FSq75kiRok+Gs7WdrHiND#MEQ~c$GKU*yY>aa|yDuh|#oE~%_
zF&{`fXDCz5!su82ab`~YnPs3lb06s?zm&57eA^d@M_j4IBWD5eh$a?p_DyrnzdB=~
zmU8KGGb*8B*1Wvkk(k5&mi%xQouWf%W)D3v;fjs%>2VCvxUFj*-*aylRE3#<$~O$N
z+3Mu=D4RbVNvWf0%+;=8-{T`LdDcCVhRQ;QL;M8U2d;fa`{~8|ltrSSmC9e+s0;M$
z+eD^?G$j!%N;G*Jlnkqi0D*fKjgQjHHL--ZRZ@M$)N69g=Q_p`ie=4_lei(UzTR@!
zW2!;CZ>!@K)OA244|ALn;SCQr(G^eiHvrW0R5=?$18>*Z?>67RY}S9tI)|F6M7?c=
zc=0(PUV1Ay(;ENeAdHeUm5}@7sewdEp9HPX;`RaC{o>+<MR`-Ir-g2{S_Z&jLEaW#
z21+AciLXo_X~$|%<rSUw+{_8i6F``hnoK=pdH*7~hg*VXHhO>B@l$fK6;&<!ovgz{
zgP-N3>s%jp$XoPknrnmHPF?uW`8-*`py$k~WYN7m?Kbr*I|RI{KFkx@4!f0_u$pOc
zA@81HnXr$h7a%)^TzS6u?95c90AS?0+A4Icqn<W1uecw3AUx5DmAq4(`o)}&yQ??t
zPfeG|f%pjz9M86bP$K8*<fym(=U=98>-S%JgW-P4O!uT$5YFmwDyu4H#4BP=S9<fJ
zGx%Mb`@KW2yV2^um{WI_**B6go8?uC&5H05AH2NsRqc=a-G!0?VIikOEt`g)k3Sm8
ziBVYW^`Y)_|9Ax+8Ey3xp{i&ZK9ppt_cNF<rYJwwQ*NqK{W1EyS2gt(>vhl3JgVo6
zjm+skAilaRjOd6+Sow{{R~`Y`u?|L!ii9Zbwe(lhBRQYPaB<7@#|FQZ|9BgFJ|4o*
zQ14%U)PVhjS#P3FDK{Lp?ZC_QrbVyzPdDP<>dG^Ed_%$BW6ql{)w7hfIW19}F=^$8
zz_JRMcW7*<kG7OD7Okh0-gm%i{2#NwEA?x?=usrPSON(89Mc>;SItA#1kC(q{71+0
z5W-|Zkpuas*96mPWA&5O+(~K@e2qXG;$KrkXcz%girzFVjc5yixvSpLG@%^R)}!C6
zBTQDv<p`!c;mL=u9x*pR!8G0`mrnEaa~7!;=Aq9G@0XUpV2nR<4PIP^CK?2(T2(ix
zrtRPLK{huS!}~y>)rnFzK8dr4#Jv;jVl`0l$0Q)&Q_)*Z?eUC$-+J+6=5YfDU6N6G
zSMOOK4!lIJ;GZ2P{uLYfotg8iZ^<W=!ipZoFZ$KzPl`lM_VZOy-sh!ZVS5)tkX1s_
zlt{HPSh?BjyqN0*`hT%wNr}Rtp?b5qh;DOpsy9UjZcP@PFf@Xrl_=bjPZoQu2RQ>-
zl|QOJ|Ctfv3q|A~xqrP)7L#)usSFyYzV!|MtH&WVWnO|9w2r8s(VGw~)hc;)W@g8f
z@t;Jn!CC4DaWCBS#Nqb{Sq~1NA;jKpGY=C<(|O`7oFNx&{_xb>90w3ytY$-OCLHE=
zk7@D%a9<$Xmi@DE&`*UL9O5>6Cyl9r^3-~8W7OinuRit9j{&hPlkU^K;aMliqDUYW
zbL<-<X*A%tFJLR-G)*+6qF3W;+qAu_9XzHWxmII6)$*CboS0lCo7BE4E;>+zJDN`t
zPsvR7^U8=WYtR;v+OV4d+XD{NI>A!`TFteUJ$ljHA_o<zxw9J@F?~)`n#)uhlxMq{
zzNl^Gj0)l;V_vU~bv>z5JzC=hG$&Is37IzhJwa2}m3Jsb@#aGv^ho<YMJY?NSr;O8
z*fRmc1VnzoFAGl@=?<Js5vP=P&>gi2HUU3n+Zo1=Pb)Tf0hxdX6<e3n2iE~C<0ac@
zXOFaDd{5E3f;COSzh7(nCz_4gbpON;^BIzq&<u&VhAQ(QhULno>C{c%A_3~RK?pKz
zJsyB=KdztwC4@^fAm>E_crbu>Cjs>BuU705C}$J2KnLLIjU#ji!JTllZx>AMDGUwL
zfDR5qA|IORS5m^NT97&oVj$ya>SU4tsC~dyspmsG;lQ=2-<N`?f$x4=aWYAVBy!L$
zAiUYe1sYLK3uMHiJAb>8Gy;BM2kqraZTKUw+s@Pk+zF_{WuuZ*P_IP~r`~}?4)v#l
zGp2oZS$%LiaLZ^Y_i0-CcK?-p=+89bH4;m8J*XRs?+=spA31{w*DqKH|F+=Qmwba?
zZKFA+t!c!e^pZ+p!%=zE{YbqUurxGf>eF!*;wkxA1#UoxXjIYLox~fM7b#q;s#6!n
z6)~8Y2P_iLuo@Q9#2TK8)5NP10k(B`9T`1an4-XtBk^$D;2;;4xAW(swr_o5bB!wa
z)Kogq=-FJ7n&DpwR8i#%J_V{Oy#~n^w%)TIVbXb)AXi#cD4f+SziG>hdD~?4WzEXx
zM&=!K#*)qZ8%s7y?dxAWP>^-JdH*4kUQ!V4mfHdYZ4l;SOKa6;gn$v7o8eaNEsfVC
z3Zx0l`?q$`D=y|;mNfh@UeW^9`plt%kM&Pm;GtTYOImjy(HfX1I^T^sF=b3IEqrUJ
zAWyjd)%<>5hcI5&)2Q5-*KZ3-*(1)Vv8knrCF4Rm2NR!a#EAk-bm30QGE^c@+Ib25
zL&MZ6gDWkhYI?3h75f<P*1N*bdx(Q-4X-(V;^`h9f7T9q0`?RaX(E_K*M&nfqBqA%
z&Oq_NOu;iq4>OKo@8OBNVdatB^!Ot+@xQxN^gng}pMe8iIV&&tMtha6BMn5xPLug4
z?bLFh+#rxz9u!5@bC{1Z4fwk0B*+4iaJuj%_s5bTI3u(@lR(KeWe~~~=nVrDvGa!L
zd=jLMMVca4xL>~|A^n?U%)+TT8FfL5*GwMOys+yUu^tBQ5g;?(>ZS12<O{9Ub0E8Q
zporl@JD^`2H=W~_Fu@}Jl-kE<k)E$!?k^p?1t20twD!%C-dJ<*U_{p`=P8^%(h-dJ
zeK3Es!KyHuF?~lZQw_y5UgOzsy^^22lP~@U88qa0Z)!(ZH^nqF?_<{SGq>Ye7z@%j
z1PMU;pz<g?_jRsX;gK{oDxlRYXpR1eBAKR|9-*Ez;r2Q{z=LK4ZV{8PIxiX{u_}42
zSUD_^^k$>LZH!&9e#E%tk(n3e=iO#ZFm`t{)(*=ftgHP+&c>0fh)zGTn^8@S<&n*0
z^JAWx%HtS%>qxKjlCP;`Q|t3G*hd@cdIFT}2MHi}qWfg$ITu#h!J<c1K}usN)`XjA
z9Ie1~`rYEoRjbMa<n;i>YDi0FA?Aru*Wd*l-4A-g&3ofL{6_7hI~0IQ%t$N&7Ltco
z=&w|IX`UN0ZQbQA0rOPYGaGqfE1g~XJ#ld~%%i{7wq)$Q<H!sd+P_7DrtMl3*T$>d
zp$npB*<qU{ZL%KKV$BmOt9?MW5US7`e%V9W9-ZEnP+11Vw*C(%{eDjDbyIBwy{kyN
zv+~t+F9>dyEE4}zUdnVS{rQI=Dz*3FrcFnhNg8=LnAr|PP1A<%4!W5?fGz#T>Vav9
z8<ClIq3dE^R(7~`d_GC05T11^|0LfS4GOhS(o7F9cONiK1`*v8e=+L3DoOvmjTanx
zPfIylP64I_RL!dk&gSqFpcbSrR`iR&;U7(fIU7}~lLDkVaoPA^^Yi~T<koMR;LkMI
zuZ}e+A^Pj=T*Xo{;GyHlu`aV4ao6C;H9ylFqDhiPI&BTJ-j%!lRl{(OS&oDB*KJPv
z6-#=P_8V&1`+~P!3h?LTz7`M+rp&L&z|q+P<{bSIrI$vF+jMRLfBs0iBKO(mqd5th
z*zn{TBGW<cU5&Zcy9#4ZtY(8)bo0A^UHbJ4A3O7$J7I>Jwx2Z3mA);{K53aNvb`!-
zpXaU1G*-Zsw%B67?u5HCag)t!M?RaF_|<tuofzwisJ&W?e*HjNkEY>*%EnH&H}@~~
z*hs8e&vxfUcGA?EF%*l$s&!l==&nsCYqi1L_=Dp@*Fi<HD17y;q+hvf^i;@?DK#Aj
z#Vm9or;({>$UI6ipC;!P=@yas1LXrDgtUZW1<Hdoq2-k%0e2t02nL`UdmiL_b-a0_
z4-|kBIwBpQ?!s~cg;AK<rhC@{R<^C89=iv8$BG(w7GKm4#(4`+h_`ZY5gFw!&*pVT
zXt6;EA-!=*4)uUd;5x{oln=?aaQhDW^FLmTOg%_#<lv-14)v-M-~awiEkF&jtR|Gh
zmU~u=m*rw(x_jGP3>xqrx2}J^uRf}~QmoYQZQj1yLMP^m)=%CrVxD+FN?awur0XO&
z3=CKdlI^YMQ%?2ml0wgDJvXNqX^dD#*!0~II7ge(cl$;y7F1j})rHnzxGFa7GSoK3
z{#m2<Suf^7f3$!HV`r+&aGmM&4#0n^%QZbIl*!9q4nrUm;9YuD3mA_T{XE_Dr<{-<
zLrKt9ACf4S&>7#CKvD60m^;e~-|VM|HLUmzxUZ`gKYB|*q!bP!7g=BQDgL4<{yWaa
zUTJg06y<tw-1HPR%Ve+Rn@?g5TvNgNoY%}?LbqMh(uN{xigih#W|=Hgr&zAR%vKSY
zD|vfVO`oQ&o4<W`O)QjOQCF$a2Tabo(`9iU>q836staU+Jdy1Q^FD14w{vPrV;&Wp
z#8nPYEUI|TIqp1Dz-ntrz^ur+1}1IWe!ua91M<we$g)|T1wjhwwIX_E{K@C4a=dq!
z^Q7rC2yu7EZ#Nb?JE|~MeoKUC%H;%#)?kIm6Jc!<Cr-6(cZrWSWzMAqF{wHsTQ9bC
z5_bxYJim9CGGF?Ln-+{e5)z+Bl77AXBg}CL`{{xHrnNc$AXp_!HJ{qxxiZ4-!TZUX
z0~Q%18o)+8*abOIW#&KI`0+?Tu*Xk}9vl?@KmWJk$36i_t$(sRA32+0m+fEGUObVC
zv}~6b9mr7J;`0V`bGC$oIGZ=`iQyAj|HEzA$u>rDHBUK{WYH>~)!U<8E?=w24})$J
z=?jG>JX8{;^FVdl&w%IO4IF>%n6{77p}3)0QeArF84=vZQ8i?$PzEpF*FLy|&fNTg
znE~MOvvY>$vg`g9w)HJ>i40~cmTsPrEXL>ooGuVVo@zW3LDhGyq$I(i$d6O7f4E;I
zZOA2D3xecRQ<H|E&wvuQ-}(Co9g5mN!MrOC1dAI_J+9rM(mkr5!J_FS@f?2qp|l2X
z*OqJP5q*i_*5wN8aJn&%%p{1L;G>g<`J1UE<X<TJ|7;uZZI-CM%>)XP$fpNjNFEAs
zYPUKDo0I|m!E&=JiX`dA86ty;@q<CaK2Xx_44;Ytd`e(br_qm_y#DQ*;>NX_K3?$y
zVPB{oAUB`-zUdoUg8I;k;ibM&=};^_2#*D*r<H~TPxE6#I>VQKY{-A$Cf$`+&@>^I
zO%(8;-T!C{CxB!d_<RcNn3n~}BlI_zVb*nmA;jcw{8Z;N3X``0ZVF#?6+;$@4o|<g
zK@C}j9(rE8)fY{5s9<^U8KU$SylJlKSAmLOva~RN{hD5CIBHZr(C<TR#d(``ytX9$
zM{e!e=i`Gr!-6fCfc-T65?1)XZ=0!hZ%&~wn8+R2$6;5o3+R6s2e)}wxa^sg)QPM>
zCetNpbsA+Ki=4{wQo%#soq7yNx37i_K_Y8`N)pm-4s+m7c0q4Z=(Kn;ZZ)Oe3uHso
zUpPfi6CVyIzRTapqq9jHeTgmrDjOz2+j}3-6}uuVOKoYmPF9$|1lkPNm8T5q`FprD
zpUoegDK(a9K{eEG=c_r~%>!5vh#oq6D4iCst!Kn?ZmH4BRGDZ{$p?rIogn8$6*dHE
zj{mv^n3a^X&K<!1GMejG!#4x9rmfd*nJMaV8D$q>wkY`0`}(K1k#b2y7N5D8Et$*E
zp)Lv9<&MugF^J}J&CqqWXT2{D7Q^=ru9x7s+vxH9JmcBR_WjY%`Nn9IpLcvPx2*4r
z+A(S%%r(?)lPLBe-=zHF2#&!S^m(9|7XYI5|Hdf<3p0G^LwSn?4ell-85n^(a3()J
zcRI6(g|13kpe|=-&+QI44Px<j+<H{nq%TH*zO)^2H1yq^ULmiG)`P9R8CPC(9B<c)
zoaNpEB<PhJ#MrD)u(|`TRqr(<&TRyyUDpYzISEF0rX@IAknh^Wx-g{*csurPlZbK5
zv?#nv?F2XqkVXwHm?^GVDLiYP{6?Jkw>V<|+A(b)M+h={po^r-Q4@u3ZPeT#NYYVL
zk-ysfBdk*AoQFz+N*6chfZ@(FOL{#nla|iQkZJkp!^v*h_-}4!K(pHoXm*cg6IaR1
z6#F&{9|4Lw0ySnhhOl&~CdB>7J7)eKYK1lW73-y0`R#!0N@{1uhHX9DdIp{^S|~ZO
zPq%|29$VKleMws0(xb)EWpTVcgn@J9IFgC`Yh3u8$DRtU)kD`PWzw7WOVD7Di1#)2
zLr&e>eHAl8CiW6IRZC~AkCbFOKEsHpc_bS+GqCe3BiPV(ID!dw%P~CC4JH8?4*<Rf
z7`p$06_zrebvn9c(H6le$n<r|L>jj~#oN5y@*;`l<mw`oKLua-^`!Hsb)-Aejpppq
zutENfL39hW-1(Em$S17?jt`*XL@RD2_j487ioa19apdz%$3J_@ens(S;nBxIOUn=?
zOkP?_v^vf|)BFc|%kFo_;A)t0i)|nG72gp_QkXXy#;_JTOn9JD{;uiJ*QQHgKTHGt
z!-oo>U?HtR>SNQ?WB$>U+z#%##0E0D2Iky*^{8l(TW|uEWBm_X^T_^rX^}=htJQhO
z*)R4UK2R{OMBGGf7N~P)yE#w;e=CZyu*3VLq~799mtK!3g>m-lR0^^>WSSVsQPM`6
zGKOj4c9z_(^q2A6_FA&ID{`-A^139hNMktr4L3ltN|P1^#Ix&dh7>&x_G!;~kl^%D
zlD-=%*nD|-4-|Fd)=QnuimS1{w|``@XV`p=8OGXtv93Z=YTFNF4a#2*um2{>@Gls4
zSV4@w2{)vNs%tFCx}g%9ctTD?8mouexm}uOwooW$=RtXB#4@{do=GdjJrTv!*lD1L
zwLvvpD!$HUn<8<CIeMMW<t=BDtd5-O;JBF)(7=PxU;$WXEqwJ`zoapG-BFC(Ex=n7
zg2+zkRL~taAH~F40I?*?^9Fh$A4dTYv<4tJT1_7EiV<_{CF`vrlyl6XfRp;w2mI3u
zP^|cvT5<|vF{`bd$Bo|b=YZti8~!-i2^GNJD?6^*1Xx`-g5tDOXThr_o;nj0XVUq7
z!}s?1!`FdDS6nO+unjCzei>l;G=KW{&8og-hE@}!s!rC%LWc2fz)~8qx~+YhNqEHV
z8yu)X1cJ7w;C1D!9|KEYG8s%k2!5W9p4NRqx8=*9s+}Zhrd;8R^>2%3b%~RI72VPL
zMu4p7UbOa!aO_N^wrY|ts6OwahB`noIyJJ87n4T~fw<?mQ)3*URNM`gPr|7gx=qPj
z_g5<eY|8l~A)Z$5O$e;lBN^r5n+X_ZJhH#m?IxhrDK}02MzG_zG{j#yhC7NOZ+CWS
zSQXJQEh|lnUP)h&vrWZf{vJv#FYMy+6lHnz{ug%UwxHG?>UbmhR@Lm_b%p16L+Wi`
z#5V-(Mh-eovt?q%Kyf^#>2xmLMb&g;1%sr_@&W20{H}y(m$T2*RcCWon&zqdhOB}+
zoAw7&Kovb2DmKn5Xi)hW)=p6A4iE~+LvPy@bgkzZvi!9qav}X>`i}D5%si|~h7ZoZ
z>Lb36<DcQ|7g^oSbg8qEK_kmCI!w1HTLE3nC7cdr2>A%BnqJjn&?p+Tb$S{v%nelu
z$MJcToR{1iY|8YYv+OFU6!goFNHFP+AknV>9Y^)&N#dvX`>!<Y|KabzmRBG=^dQ6a
zG13f~axmIddV1X7F*Ic{;i(~&RTkaqck<5DFj;M3v}JeS{#LPf8K{dxmOB#4w{V^>
zATs=CO~&UBXQ(lQ^B|Q26-d^w;4?ToBv~xaMi{dhHB+sJFOn2OokxA1ujd2(<Mg7+
z8*|kAW$4v(#Tvit6L1qt!LPV=Fim!&W;MXS1|X7VIv_sXR0}EKLtESx764T*so~3j
zfG<r4|E_HamFF$;^hP%(VrZPeIlrFg`zg&7H<(qdcTBs_!`~%rUHXnImK<TSdLjmi
z9@U&mxx`gly98ns+nR)ca$lLVlZJux*5GbXJ||7X@+@Zyt7EOzGd#^L)7WHc$*!#1
z?>MhN`!ZiL+uygD02$MdFqu#N5Ox{v>A0_LYiJ1{N+~PM_Vfkjjd8S;yz<lm+pG7o
zj<M1XX2-f-IqBTJGfo{zg!ODHb=+THAG}7-B?}T5cYA30G@r&ZDs?nP75l(qmsSwB
znYS-{&`l!i0+{<`gGrDZP4GVmf5gk#6~O}dfX@n2*0N#Slw^t9lk<{=a#`6_!UVJP
zP;83Mu>C447+w<;cK6v2YQ3as(?5s7vr7lcjf-HoMz=`78g%j~BVCt3)C43pt`m;4
zgIM4nXH5P!ps*#vI0cJQQkHi!<X7p?N3GRnz-Q?4Keah4*=RK~iJ8V?g);CfY}~&a
zRze5`6in=xG-PAq&6!4c>so8^^cE_bS+N8qNHCIwM630ojLvXNwi;MQPcQ@EQ~@@D
zl|=?T@t^+w!NUg?=s<JC2UMW{ZTI~Dt8M>3U5D{!WXO*hTJ*X*`x>%eKIlEZVO&sl
zaAtxHFtc$dd6>@UHw(MSNXn<3i>egq0+DS}RAE7p_0@DJ^LN}9n*Zc>0tcXcXQs`Z
z`Jn}9Y$Bqp+ia3GPH2>L+^uDEYkn85TX;BJr(xVcqOOF|tfOn8XI-F4b}7QF+gyvi
zFZ|6~6Jyznc{q!@KXVUf{HVoBw{m<)3ItvpjeV!lz@+{ykb5*jeU|X~e5C)omIDh6
z4RIZG&3G%ZEFruE4HoFLUC;~o-EK!6u2;IA+s#JztZcCfH=xCs>pUL@=lns1vWmkt
z(R$=<(bQbbo^ZJIlfh!UqQ={NV;j|UB=Wp-0_fLdr(KQdh8B=#3kEPhuN2;V28uPP
zvA|z`zWc9V^V?y+MoK^?Iy!uAbO4xHZn~b9ETQ~Q?{7aoa@vYLU`$IX2rPaR+H|SA
zwh<2>x~szNh1f2>E;N|5noKF|)KJ)LrWes|fqS9CO)y+~f+=AT3^sRBK-jBfMxMj$
zB3w1GVkr(laGeT7uO1CXK2zW;Bp`gVza8}f+wcC6ZydO_7uNvZEWKTgAVhtT0h9|u
zeMnz-P>u8Lr}~y-VcOyhB|+@zWJ^SUt9UKlrIM(MACRf?vLYGjdMxb0rk!8Ot5EK)
zfltI-?U0?kuK79>D;ZRLE8jMrb7Zzy;|W{44b7;0P}zxg_|qgkMMZhnySwU<wD`T}
zOg2=*ner=6n&?K1+o0}LCMp+1(M)WS#Y6cKU2yva%hPUiuCau6nIptuz%y;!x-UGo
zoKm8KzgAkK&!0n5W`WP2BC<$v;nt8987|PA@HIBk%M-+ixWZxQyU5DH-Ia73I17G9
zd*O57#qapbKg9t5SO5Q%@&~ZXLtHD$nb7^qv4fIw0b8b(i>x@B_TPRn9vxV~Rv#r0
zzozA|#hI8FJ4KE3S)g?0jgj)PPuEptxMX*4)DfqV4ZAI`*4B}JhpX(Ft9-`mYcKdU
z6P5l+lh!{P%060y9u}(KD+S;ISy;Hmr+QK3lLr9s!(5;9u5k3-BV~kTp1?$bSUvtp
zETfI*mglS}i4X6xjjy}G?uD_n0#)Mng)$rt{Y{g@&wWEXs!T9-JO=UR)sluF6FT*9
zk_yHO3pQPgg+%{_Sp6?%eg<Ifs%ds%AqSI2-Cp;rvGCVpBTdFe*AX+1ZfV&o>D-c0
z2VIy{(g_a?7!1|&A3OmX$2{XYjVQjC#D^J&l+ejYC}V-*h1ikMY3c<BRJ?p2<xkmv
zwF>l7wz`oZmfy%XQ|ocQd&OUy4KV(g=GR(mOiaH1Di=^?+pl{du*vxrDe<*+JXY0i
zn5(2a#VxeE%tj<-XRNbVW0)A864acq0i`3qEuULk1;y%j4^?u|N>;l0{Hk%2%hzJA
zYXY(~7!@Xs{qwaUe<CsecSK^0_rX#b#%-kwFC*GHFhft%uI_nRp&47r*XkhnP&qF(
z%&R&t$gpx_bzaGSMR_Z+yXUeYS9H``Vda8MWyT};Jtz!@k-TA*><8RHC7Qg}B%_;+
zH|rGdQ-bzJE^)l{dZ(vrwfqepzF|*~q3n3BYQA$@d1I6))Fkgl-zX_3-W$_4iAk?M
zs_I0!6OC_g4W>-{*w8!bghyKhL@O#6ojtp9gmt+CEUZnb4!Y-&Y1@0oKe%J-dKwzJ
zbWdp%>v@~t=e6`y8TPe*WSPFS&vb-pDw@^Y`o|4Hntv@8J~deG>jon1cxvI#zwj(j
zvxoz*XbW0{M}y_e*^g7W;*@d^9UD$BrDd;CBB35krqk_w%}ADYU>hXXN0hqD3XWse
z>1FQG#CfBu{O_mx=rO4Bb`=&I5%+#+f@pf1%D5&_i|OPE8P?T%e2B6#@%>s9@Fy3C
zrsM_?A9SXQ5B@7R`G5JlK+SX|;k05IuBPjK%5kH>L>Lcd#6;$?f3P#;K5o)Oh->o-
z8<w{pk7YR0V#URjVUL_CyfK=Ibxk;CMTu#Pc1aGaayD>PKOvYV+h&%1?%3!^ifW>v
z%vE+E2dO7<aXmjy1DY+G`2xq6sg$;<6yT};<@E12L*7^R)6?PY7C?l7(ViPP?{*+N
zh208@)VRh$tp?#3@=v?(FgC22qpI15yCH7toa_sCksFb>2!19iFTC>3V%G1xAI<HW
z)?^b23a#Q>tVEs?9hgNxC7xsNc>|jtGvUAL@`z39prh<v?B19aGZ&+f@%T`e+n=#A
zFv~qax8YKB?H?2<{9W$If9ZJye#-2Agv$b?odjzW(<%WE(~=uU5Zh+SZckTnyc!Nt
zn~)syW?_D2@ArTOy2mWcnw^NeHpfY}cB-zZ)EYtx+RqjQsNHZgt!+{wvLOB|Mqkur
zWJ?BjQhVwT*4^f&7n#FB1XLd@^Cxv>BzR3bf4~0aFT5732ecUg*i5>sFEKg+M7BV0
zr25VXp&#*IU+?q~FK<tonAt&+d0~flbT}q$)!HVYoOAY0u<9A2v?eH=F&wGo*YDV{
z@n#N9-s|0QqGPM#XGn!d@^e~(sZx~J^*cvuVf#_2J)&c;cZXFY5StTcf;MC9fMDgv
zlVGv>A5S4f?VmxLf%dxP9in@D<siB*wZ1+{_v809*WqJ-zjW#IX#>?^Ze1ZV1^f_S
za~%Iy_cQ*Oe$|?AN7@$V66yN|c>pi@(Vj{ep<d*g`ex_Z0xtz)C;LZ;@Rt@osw2);
zz7NLn(B%Scxy>0(qXKnXEo~*UXfPUc<U`jcfeMSziDspj4Hn(Gy3&y5xg0WN^8X$0
z_LE!mU-SPXR~EqCSE?b)aWq2|(`ob#BozY!9NFIlWq&a$6F5|Wj=<_cp!?uMEf5FQ
zK3YI;tMhN#WV++7Z4$1h3g;MrR?4oC^H!yJ``D!HfL+|$#p=Xjz^lEZJ}JqBzrsZX
za_uFi(y1OK9^Zm@d7|}1Lvt+88}1FK2AfYvKfwU4ifbm<a8ykUI57g?aetfaqThKG
zlsi*9?I-u_e>DR2d-wfgns%kXzU0<}+;Q%h2B6z})_)SiIYb>e{=cBpe-SwO3q#UB
z<@*eVTMv>I@K7LZTt@>=Af`il$cKz%9*w{1vVO8Tq&K^i;K@7z#DgMlL;{DC^xB1f
z=#H<_QU+o(UMDvlCD1po*TvkN(%f_@rrx~nsk9z@bMB&nTSWB?oT)I@54(%wrWR*(
zf=Qagqnv0MRjA^+SM}C#KBVfHj@|HJ7;0+YFrRy_V}xa|by-!Www}o*9^ZPW4tmq$
zka4h=El0f-pt&sgL86uYCXwa9C=fi-83;E@=Co&n46$;-3!SwgZm=0M#S3Jf`@LZT
z)J>E~M$)HQ0L!H%AcK1b$l!i03G%<Xf2BNMR0=Zpxdw($YIl?<9J-SETx{dbX?OAP
zsZ$(tfONvGxG>+YIjf6P-p0+TGE{nZIgIbKPHOsJS;O-Wt~;WFEN;a}YfuNlCXyoD
z2_N{<2EZ#{&{E<HfwnnyP6)=#Raj6QTmG#JIwo;~rac6|i)31@ogmEgXvvKT6xey!
z-Ie2Z3hwqM^LWMEFW_iQ%%W@)YwG-P2b9oX?iN}>4RFXbA_CNH+43RX8Nsi0qZTWD
z?`>ZS>3y~hq*}A|L91D;^futEu6kux5-5h)r<?9oqVB2fuIsWpnKf{_<?=GbFeJH;
z)}>LW3#F|@WO5WXjxo5qv!6IqlwMqtlx3EQ+8WjDeTnXnf1^ivhuUSjqq;zXVd7IL
zX#7_biNC~#^*?lu_4t*yI6G{8G`07E%6U#k5-4Exqcb(B>be9t&h+);^b8!rIH;;A
zHhO<N<D}2e4<!Nhicpel_DTQQT<;9ig(WvNBvaoOy_7Q1LZ0RkOVyI;k+!*--r9t4
z1@E}$>J1jN%wB!tI(Ff61+ZTKfk;j9g`7zX>9<RTZx4_kj$UzFCs}KZkvvC$NkR&7
z)M|22^2L>3-+YN7DVYzuXHo0SGNkH8D~GPge;c#;!=c_IC2<?w8sRf=XoV-slb6Me
za-l)~nAUo?IhhGJ7^OZcUt2~%cEWSpRitS7dYu<(aTiMtpDr1(vlZ)|C9;$QOJmC?
zk;?}(*hm0iBB}p<I{I6u|MRIg<MRFXm6lR8Gt37cBHJq4)b+GJe(`d*5cGGWs-&((
zTU|G_1QeaH;78Uk*pxRmp<7!|R1;J}I%H6J^nl__<Wru8@MBTmf3bi1pY)Sg2FPl3
zO|5%5j`kfo72O9Sy7cgxpUMq@JoD$z?(=1uuC5!Docw$<12@v-Z0_C!ZU0$PuCSAq
z^pvpmd3TeDo$EG+-`%%gJJ?k?OL$y+_q7g&3ewreRyiGoSU+>=b57NPyOUQN7rq~t
zSm`=c1H2y8jewyNEW~$WA-lv;{x+}3gHq<yEx`WJJQ&9cj_YIS0W&nr2E=K*6PG5w
zJy!JJZ{l;s;gGKi#kJO>!H16h^z^)Vc28XStMixNpVxzKlgP^Ctm;#bY<#sXO0I(Z
za;};L)SM&STd^@xESf{P@M!y*IX7A!;oj&tn}>_4>H|41eprSA!(=b1xqI66*J;UG
zh*mt%FiLwCh6HT5Hc$I_59BIbOo+xYSRfocT~3V#Ayh5HqVHh1=K0H=EN?vAJCpO`
z;sTCgn>JZmo9wxiBA~ae6=*j*IdR)m2XJT+iA{h4QGL1NUN$Izl~gp-HC4$NF_WRz
zrrye7q=4|Goq(Q9hy)B}y^tQqNXf$jT9z3T-9PEO{V7N9`@vswjaTQOLDMe+uX+*`
z`K@UpiHf;v^3Om7v+HIWW__S)2~GvPefHJW`S~`nxlu38xFs@~8GG>;$5yQ~08(U3
zAmZCPm(w~&WGW~;QZ}ibqUHuz68CHh?i`J?fv9`=%Yz(y!-TR)ubasH*0WzdFsD`@
zd=(dlql+NHf1FNfYzBgvx<_ZV|JF$Qf6^R(_1cEs;nVEK2HofpN1l?1cZSgJ8-%42
znl0-p_FSn-8J6}fgAEq#u6Hr<-yqD}!*^4oT$b&84QBm|-2NjiHv&!<RZ4I?=?Qir
zKg5ni1W4R8xmm=aoTwE)2Z%z~Xks^xV|Z|(MSDp47E=#6BT*hu09P)xn4bR-_1)+O
znKwp2_h#nq26M~n02oNH2@qkM*Dgj(?(8}GDjZk)#vBy>b+%;_*NG{kuO9#+Q}T#4
z=LE?7D~qDo=h~CnU=`BG{=BG<o9|rc1bZ;+OujFEZ-?(M!GBR_z%l>azg-VaBYnw~
z;-H_pbMjupyj3Uo#vi+#xZ1JNEstyOi^o}cptpByu|Wx_sN1NHExFNnByO&?I5M{6
zu_IG(zagz=KM1o$w{a=ADc+0g4gZhX1h%A?<_AhAj5I)w1DZhAoZvY@mH7sF4{D;L
z%A|^#=$NLaKfdq$Cp7|ns<d;Zy13w5d7r6QAulDLmDJY7)P+eI`%5*k)h)1)bw7J{
zFz>;=0xbiQ7?n(o62rPPhxpha_cq@G8D+6N%XzHBi0Mo9K{Tuqe8o~cHT0U>n>BMW
zkQaFDh||vmUUDlY^~6AKhWi;?GSbtPlbd#X3j5~x&Jx+$>awcTuPT*XkOAyOo!90Z
z+-P2GP~$MZmzO>ySohj<GdPUMnBubaELl|1m&95-1`6h%{gVMozn8E2zWtBsRQ{LS
zXSr+Tm7cy&lCo#>q~*8zptcP4l0Nh=LwV}&=78u+m|{VRz|@TeM<9I=I$Q94&)?7n
zg;8@c4xwJlP?x~_!^;rakh^#Fkqaw}7(RML#8TxlWDxr5<%bG^{?M5wAU3fKP2w14
zH;#F(TJ-slx(p3JUh>c+zxt5>)4quV`Ib=cMfILg>aIOMKQP*0{H@O(THL?7hY(P*
z=I3*KcIGe@l;rsj1D{@;xT(iKy)?AM?CNFc=k?Ey3R7YE{;f}K_D^XI)0gi;xk=`E
zJ?|eKo#b4GJi$wf3w00eQoj$DFzc70(c$+C7C_|k;7irE^O2zoJ>qZAEXgf}E_A~R
zv4F4br(?DMqnmMteTAQXw!z`0ck{Awp&u%so!NyU7naWV##Jmsmlrzd`%q{4mZ67B
zZi{;s)ydGV@4LS@%lFseAJq*=2j8p52mnLmI$Pj!wylY?0dns&zkdHi`=s{AzDqNO
z(4Pu@@u7UBYllgH-}}8azP}sPVebD%U(odXK)SK!Ic}wUr-`<wo=_OxHUqN(6)|g;
zyFX6Ni*eQic7=y<7x~@^+{=1RdUNDl{!zc!c_PzTvDt$GTZy3f0=0MQEkzw4bESyD
zmO9V-b-p>p{KvwOCT0V+XKf?HWA)}1qPt#@Q>J}HGsHA*skM_Ji)>ORvlL0DMW!zM
z5AeXK`t@fN)hBQlXQ$>n=z~#@dN;&Nk2?wm$A%`GfA&4(IQ&v*vFU>uE<kaiLC4F_
zrn50Qa#Txj4(gygV3x+WZ6Ue6pn)n%myc3C>49_{W1v>io#U6gf<=WeQTHHs^7&P<
zXQt(X^CB(y?ycnrsV358<5hkDWj?uXF4#w7EowS~<_91Xqa8u3+4TkX{#1i!TC{bk
z!$^%<50tz1?(L175ii_JVo$DSIq!!DIIZtl`>&>Y{%6_<2XjDZ=>m~GMEB0Igrbu*
z^Jf=xhzmXBbl1M4w?|6fyG}2<k|DoxE0dsXt(M(gqdwD_C&%ro>2)nRg~`7yhqO3f
zw(E&)%RWUT$&&Ie@^B?KU37EYS;2Mb(9;64{?s<N=`{Noyll&mljVUj-BqchrX^ds
zA?H7Aaf`)C#<GXC5k8Fh4(dw>VB7IG9PQ`&-^%O?3z#-uhKdSSkP?8iXT?xVmB-C9
zHY`Il%TPy*i+yOF=7-Q~n_%tt5!uU7c<7kc<<Mt)mm&2>L^i2CA2ePsLpMWbHrg2m
z_T6|NL0X2wmZ7ojRp}7QdgI~KmYg5n@S0m3HcZ}lJyv%$oI`Gw4##ly&=HzdZ3&O)
zKU9<7WyiwV>lF&dP#6s^IF4~+h>vJ5Swwc&@7D8&SYuvffXff?hkjlivCIu3gVy&~
z={!N`T`|5Ci)zcj&neoR)Cs#e2jT$50Mc~k<W%|rtCLF(d?lVNSMJXR^LQ^qDT#gy
zp(h+x?vcJ&U)M+U_3$unVld2h&ku1R&Jg<k;4*Z<qFg^UD|t9R{2A<6h_+Af)jsIi
zGV}yQ7xI>&cQ2Qr-Er@<Z;apguyq-_UkYGi|Hi#t8YY5|rJp?VYML!Q%`S{PC6hyh
zci!$MKvtr~4{|w9J3QG_nN@n_Vnx#)X{E*IXjp4%GZ(z&q7H5Pg^wBK1844UaX*b9
zmBLT7@&-)V4JipOSoU6(^XHA2zQig}zYN7d(go|E_OAK?a-Fy3YoAAWJ*&BL@yhzJ
z#MY$n^PvEo_Q8;UP+`LM;FCKaDh%cI$2uK#Wr}2!_!ysH)(#BVJ-WC-oba~E#*0*a
zwaS{-YasJzg#3kqi`89O*Ag)C86n#0PttFWHxrqsi3(lU=%)LEds5|*WUu$BG==vL
zI;OWz-YM=~zd1-;eUoRaJmjG-IWRV*c5hYjk$lc}q05_`%TJ`+CQG+$i74APE1eUZ
z<W+IyDd)oB^ERzSwgIoZ#|GMYlGHOLS+2~+%?3W6ZGSJx5ymo5z6@z}<z7=&y@3in
z|AtaFbUHt6uThDgO>lkjGtrDa``P0f!(=CVNS&7nEkz}M;hBT8mgnKd=wlL%JFl`p
zW96-rXCDsoM5`b~qE}0v3!u?5A8`t|O}fLM?Cm9}e6H!<?aKKn+*n85oAR!;s@LoV
z%pU(hWD8N@d~v0}Qcg!v@giSwLek61?)$dxo)XtRtDUtsG1X-z-`m~Kv-8RstAX~`
zSt27T{P6nPLC7rT#!_&WmXT~99-7=FUhaJO@Q#fZitE*MOO39~7|$k!-j}l`z`7r`
zANKOumx4E*ZhRqqnC1C&scW_Gea2@dv8lzYiuVv%M4lXKWPE2aV70IJ%G|yzC%^U^
za9G3_>R3L9LVaKUW60nCsrIq8;ib{fkqm8>O_-IBvR$AHcS#iP2@?iDs@V>P?vy+J
z{(LR^9}0$wGVqDhI#bz)vvc-G)5eCJkRoR&oPD41{<*kVb<}|V)TI&wg}MuwDhU{#
zg~QEPPR;E<Lg9^Rx=$=o+YjUGNDdt(-dVtpP46RKWfEm%&y;PjpM1@bu5{9Z?mV#7
zJs3_M#5s$5J>p6CX|8%*+1~hct4WpCwd(1k6|KF4=a(VD$s74IMAk#YTbj!Xp|YFp
zdMQtPJ$D`{)V>?+n6ZSa4OBU#7+BV}|7_-#z;%xY!<3`WDwApEAJ9i)7|%Br^+Z*>
zq(2!v%A?ejx78vTLfQIr+>4QEVc=RYx7fta^-M<ts%|udf>~5_!iSYjw=k6)KIg$H
zCR4Pb&)3MW&BL}%>WPl|h(x2Izg4jOohp|w1}%}<MmY>0dY!f(M;lj5g}=><i>d{u
z@1Bl-Ff&tntfl`&N-IoRI5DKnKe&e&=~K?oOvv0Cf#Iy^aX)PzU4~tJ$aPSTy{oU<
z=3&Q;VbJPTp{YdHz{RG?UF%xX4NHX3mMI$5QC2FC4=s86*pA#B&N7mK$<yHv>r^li
zHab>>%`QVic@@r=yS6=q?;VjkX6)@DHh)00{gt{vTH%z_t}Qq1bkE4~ud9F*-gxz<
zZWfIeIeU?5SQy=^!IzTh^N_ZA>O{NGn+Vg#DifCKo~M#u$K5?i((rrZ7SH~09%vI5
z(CBi>Z)KKdLA9+Bx!|`m-hEC{Ht1rQ)>N&>hqDbQhWStUEpUevUketwdy+9wU6lnQ
zZA(7r!<8K7%omvP^s?vS?Jn+4$6rUM319KY-%{mYDXXV-Xk8R;29f*rw9KP(Go;?l
zf;F<IRu84!xy9!<Ia7plpF4wmrpZ4#+bnRm+iLygzWB?fl;8vEEn(>L!_88x$NbB;
z$@m%@EQGjk4!xurH={bAHvBTw=3Zq*=2&w0LH7H^4*{DNLPjqIC23cL>|gU54KrGq
z{q(LlHRA``jCxmD91BF5shz%Obl5VqfA~YsqW9{%ACwyVTC&4bb{U&hWcColqc$`-
z$VOz&w*6R~kGd?(V0KKI&dN4#qS%*Ck#5tuI2Vv}xGxL@GCc0`;0T4y!!tA`wz~2Q
zVi{Gj@>~vE!>wm<45j%2yd^2U%g{tNC;zic1=+t_7|a{ndGUaf;0X7GR6z62?E^F=
zTf^f$le5FNGFQ}~_YAmb_D8Sjt@b>7TAH+_B}koE@EJnA;z<vD`^8<`FVijNzFlH-
zGQn)v?Bi4$F9#Lnu;f(O?b7Qmn(r;TOJsdss?O2`RF`)@zH`Vzhw1d3xw%48l;`nt
zXMA@*K4Fy|CVn;5&QA4KV5FL)UcZHo6t)<{>!0bDao)gE9u6Z*XSs{)i*mzTuVoUB
zJDLpCU}1r;-%NROO!beJ4pz6B0)~oe#{*aVgBlbw?ERx%Z|D_GQ<M|#>GPg%1Qp(h
zP~+?CrQ1heZj!yvxx|Lc4pZp2C=cA!>!v%BsJ#rW+qq8Vj-(EL?Yj7!3czx1S5~tK
z{}4Fvo;~_$k?f=T1pwZs)!3Z8iMzd(uI%1KJGfqrbI@Cb!2X)xsmW*ylmwCO!qisn
z`H^zd57m<k7CikAH`{H1Ssb$9D>?`Na>2{rD2(-4HOTjC{lnYUJpS(6*Cm}9Thalm
z?sUn^p=&1PQ%5I)!B9A{`Ndgv_4YphjH&k4^CZ7r$_T|iZ@<d6Bf;KiSl{kFw_Ni5
z9xV|9fEBP>hi><iG~C!KTd?rjjYv~2<vo0ia)_6M5-Z#Fs$@ZeM(0QtD(%f>)nT&R
zz=Y5Lo6d`GH(k2l@qhdmIu%%cyb?FNp0n9y%_hOm&m~Of0>dnTGl=5>u;Aj||MvFU
zRZQ#LgQ~Cl=Ns&3RAZKID~ziST6*N;x*JbY<r*evFfZJDO|9wW!p@LYGBV%Sc%MG0
zpZZzl0b>Ju)(YT723-u=&c3_*&OJD-p(3i>e`xcI1q^d0Wv5C1j?|rY>z~oR_`9iJ
z{v1sXbdU=FezIsK5BDaGU(DB*HT}B!Htf<*ZkFF`_GZg<F<jrVZ=2Y%b4R&W%WTYB
zHZ!$WBw*{(OX8h<6|Z<xfrq$$H~;pZA?>&9BoU{gBVSF64n;h?lu{X9m48s~IMdEk
zJEphl%sZXWck}N2<v#-0+P}3<U86Tma6`GooxA&kBT66xD&h)P^mQknZu4FJvY~#)
z+StmAe|lTwBtE_<jQJ|Uc;SU!=kxap1<U6<&N?+eV9!o}y-aicWeoqER$c^mc;x?I
Xhm3L!;!|=)@?wfnzmvYu=KoCqAX-r@

literal 0
HcmV?d00001

diff --git a/docs/community/powered-by-faust/index.html b/docs/community/powered-by-faust/index.html
index 43bba3731..d06f4c5ff 100644
--- a/docs/community/powered-by-faust/index.html
+++ b/docs/community/powered-by-faust/index.html
@@ -168,6 +168,10 @@
             
             <li class="nav-item" data-level="1"><a href="#powered-by-faust" class="nav-link">Powered By Faust</a>
               <ul class="nav flex-column">
+            <li class="nav-item" data-level="2"><a href="#faust-in-cablesjl" class="nav-link">Faust in Cables.jl</a>
+              <ul class="nav flex-column">
+              </ul>
+            </li>
             <li class="nav-item" data-level="2"><a href="#polyblep-hole" class="nav-link">polyBLEP HOLE</a>
               <ul class="nav flex-column">
               </ul>
@@ -1077,6 +1081,10 @@
 
 <h1 id="powered-by-faust">Powered By Faust</h1>
 <p>This page lists the projects using Faust in different ways: musical pieces or artistic projects, plugins or standalone applications, integration in audio programming environments, development tools, commercial applications, research projects (possibly non musical), embedded devices, Web applications, etc.</p>
+<h2 id="faust-in-cablesjl"><a href="https://av.tib.eu/media/67445">Faust in Cables.jl</a></h2>
+<div><a href="https://av.tib.eu/media/67445"><img width="50%" class="mx-auto d-block" src="img/faust-cables.jpg"></a> </div>
+
+<p>Explore the dynamic integration of the Faust audio library within Cables in this video. This segment delves into the intricacies of generating rich audio experiences on the web, leveraging Faust's advanced capabilities for real-time audio synthesis with synthesizers and oscillators. Discover how to seamlessly compile, modify, and visualize audio within Cables, enhancing your projects with intricate audio-visual synchronization and interactive controls, inviting viewers to contribute and experiment with this powerful tool.</p>
 <h2 id="polyblep-hole"><a href="https://patchstorage.com/polyblep-hole/">polyBLEP HOLE</a></h2>
 <div><a href="https://patchstorage.com/polyblep-hole/"><img width="50%" class="mx-auto d-block" src="img/polyblep-hole.jpg"></a> </div>
 
diff --git a/docs/index.html b/docs/index.html
index e1619a841..4c3a658d3 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -466,5 +466,5 @@ <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
 
 <!--
 MkDocs version : 1.4.3
-Build Date UTC : 2024-04-20 13:53:22.976619+00:00
+Build Date UTC : 2024-04-27 10:31:47.820059+00:00
 -->
diff --git a/docs/search/search_index.json b/docs/search/search_index.json
index 225d8f5a4..c5f8104ef 100644
--- a/docs/search/search_index.json
+++ b/docs/search/search_index.json
@@ -1 +1 @@
-{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"What is Faust? Faust (Functional Audio Stream) is a functional programming language for sound synthesis and audio processing with a strong focus on the design of synthesizers, musical instruments, audio effects, etc. created at the GRAME-CNCM Research Department . Faust targets high-performance signal processing applications and audio plug-ins for a variety of platforms and standards. The core component of Faust is its compiler. It allows to \"translate\" any Faust digital signal processing (DSP) specification to a wide range of non-domain specific languages such as C++, C, LLVM bit code, WebAssembly, Rust, etc. In this regard, Faust can be seen as an alternative to C++ but is much simpler and intuitive to learn. Thanks to a wrapping system called \"architectures,\" codes generated by Faust can be easily compiled into a wide variety of objects ranging from audio plug-ins to standalone applications or smartphone and web apps, etc. The Faust Web IDE Getting Started If You're in a Hurry If you\u2019re in a hurry and just wanna have a look at how Faust programs look like, you can simply check the Faust Examples . If You Wanna Get Started With Faust If you\u2019re looking for a step by step tutorial of approximately 2 hours that will walk you through writing simple Faust programs and give you an overview of what Faust can do, have a look at our Quick Start Tutorial . If You\u2019re Looking for the \"Manual\" Faust\u2019s syntax and features are thoroughly documented in the Faust Manual . This resource contains hundreds of code examples and many short tutorials. If You\u2019re Looking for the Documentation of a Function in the Faust Libraries The documentation of Faust's standard libraries is automatically generated directly from the libraries' source code. If You prefer Video Tutorials Check out the Faust Kadenze course . If You want to discover Projects Powered by Faust Check out the Powered by Faust page. If You're looking for Papers on Faust Check out Faust papers and reports on HAL . Faust News >> February 21, 2024: GRAME has been selected as a Google Summer of Code 2024 mentor organization Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the third consecutive year, GRAME has been selected as a mentor organization for the Faust project. >> December 02, 2023: Programmable Audio Workshop (PAW-23) The 6th edition of Programmable Audio Workshop (PAW) will be held on December 2rd at the Marie Curie Library of INSA Lyon (France) on the La Doua campus and is organised by the Emeraude INRIA/INSA/GRAME-CNCM team. This year's theme is \"Artificial intelligence and audio programming languages\", with a strong focus on computer-aided music languages (Faust, ChucK, and PureData). Full program, details of the talks and registration on the PAW website . >> September 09, 2023: faust-web-component released ! Result of Ian Clester Google Summer of Code project, the faust-web-component package provides two web components for embedding interactive Faust snippets in web pages: <faust-editor> displays an editor (using CodeMirror 6 ) with executable, editable Faust code, along with some bells & whistles (controls, block diagram, plots) in a side pane. This component is ideal for demonstrating some code in Faust and allowing the reader to try it out and tweak it themselves without having to leave the page, and can been tested here . <faust-widget> just shows the controls and does not allow editing, so it serves simply as a way to embed interactive DSP, and can been tested here . These components are built on top of faustwasm and faust-ui packages and is released as a npm package . >> September 06, 2023: faust2rnbo released ! The faust2rnbo tool transforms a Faust DSP program into a RNBO patch containing a rnbo~ object and including the codebox code as a subpatch. The tool has been deployed on the Faust remote compilation service, to be used from the Faust Web IDE . All is explained in Using Faust in RNBO with codebox~ tutorial and can be used with the just released Max 8.5.6 version . >> August 28, 2023: Google Summer of Code projects finished Automatic Differentiation in the Faust Compiler aimed at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project was worked by Thomas Rushton and completed with this Pull Request , and finally integrated in the Faust master-branch . Better Faust on the Web aimed at enhancing Faust\u2019s support for the web platform, and was worked on by Ian Clester . Transitioning the Faust web tools to a rewritten TypeScript version has been completed and deployed in updated versions of the Faust editor and Faust playground and soon in the Faust Web IDE with this Pull Request . A Faust web component embedding the libfaust JS/WebAssembly compiler has been developed and will be used soon in the Faust documentation . The development is fully detailed in this blog post . Thanks Thomas Rushton and Ian Clester for the hard work during the three months period, and Agathe Herrou , David Braun and Jason Freeman for helping mentoring the two projects. >> May 15, 2023: ADCx San Francisco Audio Dev Talks The Audio Developer Conference San Francisco is a one day meet-up for audio developers by the bay. Two conferences are talking about Faust: High-Level Programming of FPGAs for Audio Real-Time Signal Processing Applications by Romain Michon, which can be seen here . Using Faust in JUCE Projects by Julius Smith, which can be seen here . And even the following one with ChatGPT generating running Faust code: Democratization of Audio Dev: How it started, Where it's going by Aurelius Prochazka. >> May 04, 2023: Two Google Summer of Code projects attributed Two projects have finally been attributed to GRAME: Automatic Differentiation in the Faust Compiler aims at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project will be worked on by Thomas Rushton . Better Faust on the Web aims at enhancing Faust\u2019s support for the web platform: transition the Faust web tools to a rewritten TypeScript version, extend the Faust Web IDE, enhance Faust\u2019s online documentation, and prototype an experimental platform for sharing Faust code on the web. The project will be worked on by Ian Clester . Welcome to both of you in the Faust community ! >> March 24, 2023: Zen Flute 1\u00b0 price at Guthman Musical Instrument 2023 Competition, with Faust inside ! The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board . >> February 22, 2023: GRAME has been selected as a Google Summer of Code 2023 mentor organization Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the second consecutive year, GRAME has been selected as a mentor organization for the Faust project. >> December 03, 2022: Programmable Audio Workshop (PAW-22) The 5th edition of Programmable Audio Workshop (PAW) will be held on December 3rd at the CITI laboratory of INSA Lyon on the La Doua campus. It will be organized this year by the EMERAUDE (Embedded Programmable Audio Systems) team created in 2022 and associating INSA-Lyon, INRIA and GRAME. With 7 conferences in the morning and 4 workshops in the afternoon, PAW addresses this year the theme of networked embedded audio systems, with a particular focus on spatialized sound and FPGAs (Field-Programmable Gate Arrays). Full program, details of the talks and registration on the PAW website . >> October 13, 2022: Google Summer of Code project finished Faust Integration in HISE aimed at integrating support for the Faust audio programming language into HISE, an extensive framework for the creation of sample-based virtual musical instruments. The project has been completed by Roman Sommer with the help of Christoph Hart as mentor, and announced here . >> June 5-12, 2022: Sound Music Computing (SMC-22) at Saint-Etienne (France) SMC-22 (Sound and Music Computing) is a multifaceted event around acoustics, music, and audio technology. It will take place in Saint-\u00c9tienne (France) on June 4-12, 2022 and will have the following theme: Music Technology and Design. As the first \"in person\" edition of SMC after 2 years of COVID-19 pandemic, we aim at widening the public of this event by (i) broadening the scope of SMC concerts through a digital art festival opened to the public, (ii) involving local schools and publics, and (iii) strengthening connections between academia and the industry. SMC-22 will be a combination of a Summer School (June 5-7, 2022), the International Faust Conference (June 7, 2022), the SMC Scientific Conference , Industry-Oriented Events , a Festival (June 8-11, 2022), and a STEAM (Science Technology Engineering Arts and Mathematics) Fair - \"Faites du son!\" (June 9-12). Most Faust related presentations are obviously part of IFC, but several SMC presentations are related to Faust. >> June 7, 2022: Third International Faust Conference (IFC-22) in conjunction with SMC 2022 at Saint-Etienne (France) The International Faust Conference aims at gathering researchers, developers, musicians, computer artists using the Faust programming language. The Third International Faust Conference (IFC-22) will propose sessions of paper presentations, as well as thematic round tables, demonstrations, and tutorials. Participants are encouraged to present current works, projects, etc. and to discuss future directions for Faust and its community. IFC-22 is organized by GRAME-CNCM , INRIA , and Universit\u00e9 Jean Monnet in conjunction with SMC 2022 . It will take place on June 7, 2022 at the Centre des Savoirs pour l\u2019Innovation (CSI) of the Universit\u00e9 Jean Monnet of Saint-Etienne (France). >> May 20, 2022: Two Google Summer of Code projects attributed Two projects have finally been attributed to GRAME: Faust Integration in HISE aims at integrating support for the Faust audio programming language into HISE , an extensive framework for the creation of sample-based virtual musical instruments. The project will be worked on by Roman Sommer . Integrating Faust Into the Bespoke DAW aims at extending the modular Bespoke engine with Faust, allowing for both static compilation of modules, and potentially dynamic programming within Bespoke. The project will be worked on by Drew James . Welcome to both of you in the Faust community ! >> March 7, 2022: GRAME has been selected as a Google Summer of Code 2022 mentor organization Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. GRAME has been selected as a mentor organization for the Faust project. >> February 5, 2022: Open Science Award for Open Source Research Software for Faust Great birthday present for the 20th anniversary of the Faust language! Developed by Grame since 2002, supported by a whole community of users and contributors, Faust is one of the four winners of the Open Science Award for Open Source Research Software (documentation category) awarded at the Open Science European Conference (OSEC). >> December 18, 2021: Programmable Audio Workshop (PAW-21) With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! The 6 talks and 4 workshops of PAW 2021 , will offer a unique opportunity to discover Procedural Audio in relation with video game engines! >> February 1, 2021: Faust Physical Modeling Workshop -- Online Event Faust has been used for the physical modeling of musical instruments for many years now. Various tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day workshop was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques. It took place online on Feb. 1, 2021, 3-9pm GMT+1. Additional information about this event can be found here . >> November 21, 2020: Programmable Audio Workshop (PAW-20) -- Online Event With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! PAW-20 will be a fully online event. Information about the free registration process will be posted soon! PAW 2019 >> December 1-2, 2020: International Faust Conference 2020 (IFC-20) -- Online Event The Second International Faust Conference (IFC-20) will take place at the Maison des Sciences de l\u2019Homme Paris Nord (Saint-Denis, France) on December 1-2, 2020. It aims at gathering researchers, developers, musicians, computer artists using the Faust programming language to present current works, creations and projects and discuss future directions for Faust and its community. The 2020 edition is organized by the CICM (Centre de Recherches Informatique et Cr\u00e9ation Musicale) / MUSIDANSE Lab / Universit\u00e9 Paris 8. IFC 2018 >> FAST Project: Fast Audio Signal Processing Technologies on FPGA The FAST project will start in March 2021! It is funded by the Agence Nationale de la Recherche (ANR -- the French National Research Agency). It gathers the strength of GRAME-CNCM , CITI Lab (INSA Lyon) , and LMFA (\u00c9cole Centrale Lyon) towards two goals: facilitate the design of ultra-low latency embedded systems for real-time audio signal processing, use such systems in the context of active control of acoustics. Faust will play a central role in this project.","title":"Home"},{"location":"#what-is-faust","text":"Faust (Functional Audio Stream) is a functional programming language for sound synthesis and audio processing with a strong focus on the design of synthesizers, musical instruments, audio effects, etc. created at the GRAME-CNCM Research Department . Faust targets high-performance signal processing applications and audio plug-ins for a variety of platforms and standards. The core component of Faust is its compiler. It allows to \"translate\" any Faust digital signal processing (DSP) specification to a wide range of non-domain specific languages such as C++, C, LLVM bit code, WebAssembly, Rust, etc. In this regard, Faust can be seen as an alternative to C++ but is much simpler and intuitive to learn. Thanks to a wrapping system called \"architectures,\" codes generated by Faust can be easily compiled into a wide variety of objects ranging from audio plug-ins to standalone applications or smartphone and web apps, etc. The Faust Web IDE","title":"What is Faust?"},{"location":"#getting-started","text":"","title":"Getting Started"},{"location":"#if-youre-in-a-hurry","text":"If you\u2019re in a hurry and just wanna have a look at how Faust programs look like, you can simply check the Faust Examples .","title":"If You're in a Hurry"},{"location":"#if-you-wanna-get-started-with-faust","text":"If you\u2019re looking for a step by step tutorial of approximately 2 hours that will walk you through writing simple Faust programs and give you an overview of what Faust can do, have a look at our Quick Start Tutorial .","title":"If You Wanna Get Started With Faust"},{"location":"#if-youre-looking-for-the-manual","text":"Faust\u2019s syntax and features are thoroughly documented in the Faust Manual . This resource contains hundreds of code examples and many short tutorials.","title":"If You\u2019re Looking for the \"Manual\""},{"location":"#if-youre-looking-for-the-documentation-of-a-function-in-the-faust-libraries","text":"The documentation of Faust's standard libraries is automatically generated directly from the libraries' source code.","title":"If You\u2019re Looking for the Documentation of a Function in the Faust Libraries"},{"location":"#if-you-prefer-video-tutorials","text":"Check out the Faust Kadenze course .","title":"If You prefer Video Tutorials"},{"location":"#if-you-want-to-discover-projects-powered-by-faust","text":"Check out the Powered by Faust page.","title":"If You want to discover Projects Powered by Faust"},{"location":"#if-youre-looking-for-papers-on-faust","text":"Check out Faust papers and reports on HAL .","title":"If You're looking for Papers on Faust"},{"location":"#faust-news","text":"","title":"Faust News"},{"location":"#february-21-2024-grame-has-been-selected-as-a-google-summer-of-code-2024-mentor-organization","text":"Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the third consecutive year, GRAME has been selected as a mentor organization for the Faust project.","title":"&gt;&gt; February 21, 2024: GRAME has been selected as a Google Summer of Code 2024 mentor organization"},{"location":"#december-02-2023-programmable-audio-workshop-paw-23","text":"The 6th edition of Programmable Audio Workshop (PAW) will be held on December 2rd at the Marie Curie Library of INSA Lyon (France) on the La Doua campus and is organised by the Emeraude INRIA/INSA/GRAME-CNCM team. This year's theme is \"Artificial intelligence and audio programming languages\", with a strong focus on computer-aided music languages (Faust, ChucK, and PureData). Full program, details of the talks and registration on the PAW website .","title":"&gt;&gt; December 02, 2023: Programmable Audio Workshop (PAW-23)"},{"location":"#september-09-2023-faust-web-component-released","text":"Result of Ian Clester Google Summer of Code project, the faust-web-component package provides two web components for embedding interactive Faust snippets in web pages: <faust-editor> displays an editor (using CodeMirror 6 ) with executable, editable Faust code, along with some bells & whistles (controls, block diagram, plots) in a side pane. This component is ideal for demonstrating some code in Faust and allowing the reader to try it out and tweak it themselves without having to leave the page, and can been tested here . <faust-widget> just shows the controls and does not allow editing, so it serves simply as a way to embed interactive DSP, and can been tested here . These components are built on top of faustwasm and faust-ui packages and is released as a npm package .","title":"&gt;&gt; September 09, 2023: faust-web-component released !"},{"location":"#september-06-2023-faust2rnbo-released","text":"The faust2rnbo tool transforms a Faust DSP program into a RNBO patch containing a rnbo~ object and including the codebox code as a subpatch. The tool has been deployed on the Faust remote compilation service, to be used from the Faust Web IDE . All is explained in Using Faust in RNBO with codebox~ tutorial and can be used with the just released Max 8.5.6 version .","title":"&gt;&gt; September 06, 2023: faust2rnbo released !"},{"location":"#august-28-2023-google-summer-of-code-projects-finished","text":"Automatic Differentiation in the Faust Compiler aimed at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project was worked by Thomas Rushton and completed with this Pull Request , and finally integrated in the Faust master-branch . Better Faust on the Web aimed at enhancing Faust\u2019s support for the web platform, and was worked on by Ian Clester . Transitioning the Faust web tools to a rewritten TypeScript version has been completed and deployed in updated versions of the Faust editor and Faust playground and soon in the Faust Web IDE with this Pull Request . A Faust web component embedding the libfaust JS/WebAssembly compiler has been developed and will be used soon in the Faust documentation . The development is fully detailed in this blog post . Thanks Thomas Rushton and Ian Clester for the hard work during the three months period, and Agathe Herrou , David Braun and Jason Freeman for helping mentoring the two projects.","title":"&gt;&gt; August 28, 2023: Google Summer of Code projects finished"},{"location":"#may-15-2023-adcx-san-francisco-audio-dev-talks","text":"The Audio Developer Conference San Francisco is a one day meet-up for audio developers by the bay. Two conferences are talking about Faust: High-Level Programming of FPGAs for Audio Real-Time Signal Processing Applications by Romain Michon, which can be seen here . Using Faust in JUCE Projects by Julius Smith, which can be seen here . And even the following one with ChatGPT generating running Faust code: Democratization of Audio Dev: How it started, Where it's going by Aurelius Prochazka.","title":"&gt;&gt; May 15, 2023: ADCx San Francisco Audio Dev Talks"},{"location":"#may-04-2023-two-google-summer-of-code-projects-attributed","text":"Two projects have finally been attributed to GRAME: Automatic Differentiation in the Faust Compiler aims at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project will be worked on by Thomas Rushton . Better Faust on the Web aims at enhancing Faust\u2019s support for the web platform: transition the Faust web tools to a rewritten TypeScript version, extend the Faust Web IDE, enhance Faust\u2019s online documentation, and prototype an experimental platform for sharing Faust code on the web. The project will be worked on by Ian Clester . Welcome to both of you in the Faust community !","title":"&gt;&gt; May 04, 2023: Two Google Summer of Code projects attributed"},{"location":"#march-24-2023-zen-flute-1-price-at-guthman-musical-instrument-2023-competition-with-faust-inside","text":"The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board .","title":"&gt;&gt; March 24, 2023: Zen Flute 1\u00b0 price at Guthman Musical Instrument 2023 Competition, with Faust inside !"},{"location":"#february-22-2023-grame-has-been-selected-as-a-google-summer-of-code-2023-mentor-organization","text":"Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the second consecutive year, GRAME has been selected as a mentor organization for the Faust project.","title":"&gt;&gt; February 22, 2023: GRAME has been selected as a Google Summer of Code 2023 mentor organization"},{"location":"#december-03-2022-programmable-audio-workshop-paw-22","text":"The 5th edition of Programmable Audio Workshop (PAW) will be held on December 3rd at the CITI laboratory of INSA Lyon on the La Doua campus. It will be organized this year by the EMERAUDE (Embedded Programmable Audio Systems) team created in 2022 and associating INSA-Lyon, INRIA and GRAME. With 7 conferences in the morning and 4 workshops in the afternoon, PAW addresses this year the theme of networked embedded audio systems, with a particular focus on spatialized sound and FPGAs (Field-Programmable Gate Arrays). Full program, details of the talks and registration on the PAW website .","title":"&gt;&gt; December 03, 2022: Programmable Audio Workshop (PAW-22)"},{"location":"#october-13-2022-google-summer-of-code-project-finished","text":"Faust Integration in HISE aimed at integrating support for the Faust audio programming language into HISE, an extensive framework for the creation of sample-based virtual musical instruments. The project has been completed by Roman Sommer with the help of Christoph Hart as mentor, and announced here .","title":"&gt;&gt; October 13, 2022: Google Summer of Code project finished"},{"location":"#june-5-12-2022-sound-music-computing-smc-22-at-saint-etienne-france","text":"SMC-22 (Sound and Music Computing) is a multifaceted event around acoustics, music, and audio technology. It will take place in Saint-\u00c9tienne (France) on June 4-12, 2022 and will have the following theme: Music Technology and Design. As the first \"in person\" edition of SMC after 2 years of COVID-19 pandemic, we aim at widening the public of this event by (i) broadening the scope of SMC concerts through a digital art festival opened to the public, (ii) involving local schools and publics, and (iii) strengthening connections between academia and the industry. SMC-22 will be a combination of a Summer School (June 5-7, 2022), the International Faust Conference (June 7, 2022), the SMC Scientific Conference , Industry-Oriented Events , a Festival (June 8-11, 2022), and a STEAM (Science Technology Engineering Arts and Mathematics) Fair - \"Faites du son!\" (June 9-12). Most Faust related presentations are obviously part of IFC, but several SMC presentations are related to Faust.","title":"&gt;&gt; June 5-12, 2022: Sound Music Computing (SMC-22) at Saint-Etienne (France)"},{"location":"#june-7-2022-third-international-faust-conference-ifc-22-in-conjunction-with-smc-2022-at-saint-etienne-france","text":"The International Faust Conference aims at gathering researchers, developers, musicians, computer artists using the Faust programming language. The Third International Faust Conference (IFC-22) will propose sessions of paper presentations, as well as thematic round tables, demonstrations, and tutorials. Participants are encouraged to present current works, projects, etc. and to discuss future directions for Faust and its community. IFC-22 is organized by GRAME-CNCM , INRIA , and Universit\u00e9 Jean Monnet in conjunction with SMC 2022 . It will take place on June 7, 2022 at the Centre des Savoirs pour l\u2019Innovation (CSI) of the Universit\u00e9 Jean Monnet of Saint-Etienne (France).","title":"&gt;&gt; June 7, 2022: Third International Faust Conference (IFC-22) in conjunction with SMC 2022 at Saint-Etienne (France)"},{"location":"#may-20-2022-two-google-summer-of-code-projects-attributed","text":"Two projects have finally been attributed to GRAME: Faust Integration in HISE aims at integrating support for the Faust audio programming language into HISE , an extensive framework for the creation of sample-based virtual musical instruments. The project will be worked on by Roman Sommer . Integrating Faust Into the Bespoke DAW aims at extending the modular Bespoke engine with Faust, allowing for both static compilation of modules, and potentially dynamic programming within Bespoke. The project will be worked on by Drew James . Welcome to both of you in the Faust community !","title":"&gt;&gt; May 20, 2022: Two Google Summer of Code projects attributed"},{"location":"#march-7-2022-grame-has-been-selected-as-a-google-summer-of-code-2022-mentor-organization","text":"Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. GRAME has been selected as a mentor organization for the Faust project.","title":"&gt;&gt; March 7, 2022: GRAME has been selected as a Google Summer of Code 2022 mentor organization"},{"location":"#february-5-2022-open-science-award-for-open-source-research-software-for-faust","text":"Great birthday present for the 20th anniversary of the Faust language! Developed by Grame since 2002, supported by a whole community of users and contributors, Faust is one of the four winners of the Open Science Award for Open Source Research Software (documentation category) awarded at the Open Science European Conference (OSEC).","title":"&gt;&gt; February 5, 2022: Open Science Award for Open Source Research Software for Faust"},{"location":"#december-18-2021-programmable-audio-workshop-paw-21","text":"With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! The 6 talks and 4 workshops of PAW 2021 , will offer a unique opportunity to discover Procedural Audio in relation with video game engines!","title":"&gt;&gt; December 18, 2021: Programmable Audio Workshop (PAW-21)"},{"location":"#february-1-2021-faust-physical-modeling-workshop-online-event","text":"Faust has been used for the physical modeling of musical instruments for many years now. Various tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day workshop was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques. It took place online on Feb. 1, 2021, 3-9pm GMT+1. Additional information about this event can be found here .","title":"&gt;&gt; February 1, 2021: Faust Physical Modeling Workshop -- Online Event"},{"location":"#november-21-2020-programmable-audio-workshop-paw-20-online-event","text":"With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! PAW-20 will be a fully online event. Information about the free registration process will be posted soon! PAW 2019","title":"&gt;&gt; November 21, 2020: Programmable Audio Workshop (PAW-20) -- Online Event"},{"location":"#december-1-2-2020-international-faust-conference-2020-ifc-20-online-event","text":"The Second International Faust Conference (IFC-20) will take place at the Maison des Sciences de l\u2019Homme Paris Nord (Saint-Denis, France) on December 1-2, 2020. It aims at gathering researchers, developers, musicians, computer artists using the Faust programming language to present current works, creations and projects and discuss future directions for Faust and its community. The 2020 edition is organized by the CICM (Centre de Recherches Informatique et Cr\u00e9ation Musicale) / MUSIDANSE Lab / Universit\u00e9 Paris 8. IFC 2018","title":"&gt;&gt; December 1-2, 2020: International Faust Conference 2020 (IFC-20) -- Online Event"},{"location":"#fast-project-fast-audio-signal-processing-technologies-on-fpga","text":"The FAST project will start in March 2021! It is funded by the Agence Nationale de la Recherche (ANR -- the French National Research Agency). It gathers the strength of GRAME-CNCM , CITI Lab (INSA Lyon) , and LMFA (\u00c9cole Centrale Lyon) towards two goals: facilitate the design of ultra-low latency embedded systems for real-time audio signal processing, use such systems in the context of active control of acoustics. Faust will play a central role in this project.","title":"&gt;&gt; FAST Project: Fast Audio Signal Processing Technologies on FPGA"},{"location":"Smartphone-Privacy-Policy/","text":"Privacy Policy This smartphone application is a\u200b musical instrument.\u200b It doesn\u2019t collect any personal data of any kind. The microphone input is only used for real-time sound production and no audio recording is ever collected or transmitted. GRAME-CNCM - Centre National de Cr\u00e9ation Musicale, 26 rue Emile Decorps 69100 Villeurbanne FRANCE Phone: +33 4 72 07 37 00","title":"Smartphone Privacy Policy"},{"location":"Smartphone-Privacy-Policy/#privacy-policy","text":"This smartphone application is a\u200b musical instrument.\u200b It doesn\u2019t collect any personal data of any kind. The microphone input is only used for real-time sound production and no audio recording is ever collected or transmitted. GRAME-CNCM - Centre National de Cr\u00e9ation Musicale, 26 rue Emile Decorps 69100 Villeurbanne FRANCE Phone: +33 4 72 07 37 00","title":"Privacy Policy"},{"location":"about/","text":"The Faust Project The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Bart Brouns, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Ian Clester, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, R\u00e9mi Georges, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Agathe Herrou, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Oleg Nesterov, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Dirk Roosenburg, Thomas Rushton, Dario Sanfilippo, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Roman Sommer, Michael Wilson. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"About"},{"location":"about/#the-faust-project","text":"The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Bart Brouns, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Ian Clester, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, R\u00e9mi Georges, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Agathe Herrou, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Oleg Nesterov, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Dirk Roosenburg, Thomas Rushton, Dario Sanfilippo, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Roman Sommer, Michael Wilson. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"The Faust Project"},{"location":"downloads/","text":"Faust Downloads Faust comes in many different forms and it can be confusing to know what to install to start using this tool. We recommend you to have a look at the overview of the Faust universe section of the Faust manual . That being said, most of the features of Faust are accessible through the >> Faust Web IDE << so we recommend most people to use this tools which doesn't require any installation. Now, if you really wish to have a local version of Faust on your system, this page should give you an overview of the options that you have. Faust Compiler & libfaust Windows Look for the most recent Faust-XXX-win64.exe on: https://github.com/grame-cncm/faust/releases MacOS Look for the most recent Faust-XXX.dmg on: https://github.com/grame-cncm/faust/releases or use MacPorts or Homebrew package managers Linux Look for the most recent Faust-XXX.tar.gz on: https://github.com/grame-cncm/faust/releases or use your favorite package installer depending of your distribution Building Faust from the Source Alternatively, you might want to build Faust from scratch. For that you can either get the latest release of the Faust source or clone it from our GitRepo . Build instructions are available here . FaustLive FaustLive is an \"on-the-fly\" compiler for Faust (see the overview of the Faust universe for more information) allowing us to instantly run Faust programs. Windows Look for the most recent FaustLive-XXX-win64.exe on: https://github.com/grame-cncm/faustlive/releases MacOS Look for the most recent FaustLive-XXX.dmg on: https://github.com/grame-cncm/faustlive/releases Linux Look for the most recent FaustLive-XXX.tar.gz on: https://github.com/grame-cncm/faustlive/releases Building FaustLive from the Source Alternatively, you might want to build FaustLive from scratch. For that you can either get the latest release of the FaustLive source or clone it from our GitRepo . Faustgen Faustgen is a Max/MSP object to compile Faust code dynamically (see the overview of the Faust universe for more information). Windows Look for the most recent faustgen-XXX-win64.zip on: https://github.com/grame-cncm/faust/releases MacOS Look for the most recent faustgen-XXX-macosx.dmg on: https://github.com/grame-cncm/faust/releases FaustWorks FaustWorks is an IDE for the Faust compiler. It is not actively maintained and you should use Faust WEB IDE instead. The source code is available from the FaustWorks github repository","title":"Downloads"},{"location":"downloads/#faust-downloads","text":"Faust comes in many different forms and it can be confusing to know what to install to start using this tool. We recommend you to have a look at the overview of the Faust universe section of the Faust manual . That being said, most of the features of Faust are accessible through the >> Faust Web IDE << so we recommend most people to use this tools which doesn't require any installation. Now, if you really wish to have a local version of Faust on your system, this page should give you an overview of the options that you have.","title":"Faust Downloads"},{"location":"downloads/#faust-compiler-libfaust","text":"","title":"Faust Compiler &amp; libfaust"},{"location":"downloads/#windows","text":"Look for the most recent Faust-XXX-win64.exe on: https://github.com/grame-cncm/faust/releases","title":"Windows"},{"location":"downloads/#macos","text":"Look for the most recent Faust-XXX.dmg on: https://github.com/grame-cncm/faust/releases or use MacPorts or Homebrew package managers","title":"MacOS"},{"location":"downloads/#linux","text":"Look for the most recent Faust-XXX.tar.gz on: https://github.com/grame-cncm/faust/releases or use your favorite package installer depending of your distribution","title":"Linux"},{"location":"downloads/#building-faust-from-the-source","text":"Alternatively, you might want to build Faust from scratch. For that you can either get the latest release of the Faust source or clone it from our GitRepo . Build instructions are available here .","title":"Building Faust from the Source"},{"location":"downloads/#faustlive","text":"FaustLive is an \"on-the-fly\" compiler for Faust (see the overview of the Faust universe for more information) allowing us to instantly run Faust programs.","title":"FaustLive"},{"location":"downloads/#windows_1","text":"Look for the most recent FaustLive-XXX-win64.exe on: https://github.com/grame-cncm/faustlive/releases","title":"Windows"},{"location":"downloads/#macos_1","text":"Look for the most recent FaustLive-XXX.dmg on: https://github.com/grame-cncm/faustlive/releases","title":"MacOS"},{"location":"downloads/#linux_1","text":"Look for the most recent FaustLive-XXX.tar.gz on: https://github.com/grame-cncm/faustlive/releases","title":"Linux"},{"location":"downloads/#building-faustlive-from-the-source","text":"Alternatively, you might want to build FaustLive from scratch. For that you can either get the latest release of the FaustLive source or clone it from our GitRepo .","title":"Building FaustLive from the Source"},{"location":"downloads/#faustgen","text":"Faustgen is a Max/MSP object to compile Faust code dynamically (see the overview of the Faust universe for more information).","title":"Faustgen"},{"location":"downloads/#windows_2","text":"Look for the most recent faustgen-XXX-win64.zip on: https://github.com/grame-cncm/faust/releases","title":"Windows"},{"location":"downloads/#macos_2","text":"Look for the most recent faustgen-XXX-macosx.dmg on: https://github.com/grame-cncm/faust/releases","title":"MacOS"},{"location":"downloads/#faustworks","text":"FaustWorks is an IDE for the Faust compiler. It is not actively maintained and you should use Faust WEB IDE instead. The source code is available from the FaustWorks github repository","title":"FaustWorks"},{"location":"licence/","text":"The Faust Project The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Michael Wilson, Bart Brouns, Dirk Roosenburg. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"The Faust Project"},{"location":"licence/#the-faust-project","text":"The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Michael Wilson, Bart Brouns, Dirk Roosenburg. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"The Faust Project"},{"location":"community/bugs/","text":"Reporting Bugs The best way to report a bug in Faust or in any of its associated tool is to submit an issue on the corresponding Git repository: Report a bug in the Faust Compiler , libfaust , faustgen or any other tool part of the Faust distribution Report a bug in the Faust Web Editor Report a bug in the Faust Web IDE Report a bug in the Faust Playground Report a bug in FaustLive Report a bug in FaustWorks Report a bug in the Faust Libraries Report a bug in the Faust Web Services Report a bug in the Faust Online Compiler Report a bug/typo on this website .","title":"Reporting Bugs"},{"location":"community/bugs/#reporting-bugs","text":"The best way to report a bug in Faust or in any of its associated tool is to submit an issue on the corresponding Git repository: Report a bug in the Faust Compiler , libfaust , faustgen or any other tool part of the Faust distribution Report a bug in the Faust Web Editor Report a bug in the Faust Web IDE Report a bug in the Faust Playground Report a bug in FaustLive Report a bug in FaustWorks Report a bug in the Faust Libraries Report a bug in the Faust Web Services Report a bug in the Faust Online Compiler Report a bug/typo on this website .","title":"Reporting Bugs"},{"location":"community/events/","text":"Events Faust Day 2023 Faust Day took place at the Center for Computer Research in Music and Acoustics (CCRMA) at Stanford University on May 20th, 2023. It aimed at: giving an overview of the most recent developments in the Faust programming language, giving an introductory tutorial for those who never used Faust. Where is Faust Going as a Programming Language? -- Yann Orlarey Overview of Recent Developments in the Faust General Ecosystem -- St\u00e9phane Letz Faust and AI -- David Braun Faust in Real-Time Expressive Virtual Musical Instruments -- Julius O. Smith Real-Time Audio DSP With Faust and FPGAs -- Romain Michon Faust Physical Modeling Workshop Faust has been used for the physical modeling of musical instruments for many years now. Different tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day online workshop which took place on Feb. 1, 2021 was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques. Creating Circuit-Bendable Wave-Digital Models of Analog Audio Circuits in Faust -- Dirk Roosenburg Download this workshop's code here Wave-digital models are a well researched and popular approach for creating virtual-analog models of audio circuits for use in audio processing. wdmodels.lib is a new addition to the Faust Libraries that supports easy creation of these models in Faust. In this workshop, we will introduce the technique of wave-digital modeling of circuits by analyzing several audio circuits and exploring their implementation in wdmodels.lib . We also will discuss library support of more complex implementation tasks associated with wave-digital models, such as R-type adaptors and Multiple/Multiport non-linearities. Finally, we will conclude by exploring the capacity of Faust to \"circuit-bend\" our wave-digital models. Note : the workshop's code has been adapted to work with the latest version of the wdmodels.lib library embedded in the Faust Web IDE. You'll see some tiny syntax differences between the video and the new syntax. An Introduction to Mass-Interaction Modelling in Faust -- James Leonard and J\u00e9r\u00f4me Villeneuve Download this workshop's code here This workshop proposes an introduction to mass-interaction (sometimes referred to as mass-spring) modelling for sound synthesis in the Faust environment. After a brief historic introduction to this field, we will give a hands on tutorial on the mi_faust library, which allows simulating modular physical constructions in Faust, as well as online model scripting tools that allow for efficient model design and code generation. We will conclude with ongoing developments and perspectives, in particular regarding performance issues, possible extensions to 3-DoF physics, and the importance of modelling frameworks that allow for a creative approach to physical model design. Finite Difference Schemes Synthesis in Faust -- Riccardo Russo Download this workshop's code here Over the years, Faust proved to be a powerful tool for developing physical modeling synthesis. However, coding finite difference schemes models has always been complicated, in fact, their implementation in imperative programming languages is typically achieved using data structures, which are not available in Faust. This workshop will introduce the fds library, a new tool which allows to code linear, explicit finite difference schemes physical models in Faust, based on a cellular automata formalism. We will start with a brief introduction on how finite difference schemes work and what is their place within the scope physical modeling techniques. Then, we will focus on how to implement the algorithms we obtained on paper in Faust and, lastly, we will see how the fds library can be used to code such algorithms in a much easier way. By the end of the tutorial you should have quite an understanding on the basic principles of finite difference schemes, on the roles of the different functions inside the fds library and on how they can be used to easily obtain a working fds physical model. break Introduction to the Faust Physical Modeling Toolkit -- Romain Michon Download this workshop's code here A series of tools to facilitate the implementation of waveguide and modal physical models of musical instruments have been developed over the years by the Faust team to become the \"Faust Physical Modeling Toolkit.\" This comprises the Faust Physical Modeling library ( pm.lib ) as well as mesh2faust , a tool to convert 3D meshes into modal physical models compatible with pm.lib . During this workshop, we will provide a step-by-step tutorial on how to use these different tools to implement various kinds of physical models from scratch. Overview of Physical Modeling Formulations and Faust Implementations -- Julius O. Smith Download this workshop's code is available at https://ccrma.stanford.edu/~jos/aspf/Appendix_A_State_Space_Models.html#code:statespace and https://ccrma.stanford.edu/~jos/aspf/State_Space_BiQuad_FAUST.html#code:statespaceBiquad A summary of methods for physical modeling is followed by some examples in Faust. Physical models normally start out as differential equations which are then digitized to yield finite-difference schemes as were discussed earlier in this workshop. Wave digital and digital waveguide formulations were also discussed. Two additional topics are state-space models and modal representations which can be obtained by diagonalizing state-space models. As a result, this talk focuses primarily on state-space models and how to diagonalize them.","title":"Events"},{"location":"community/events/#events","text":"","title":"Events"},{"location":"community/events/#faust-day-2023","text":"Faust Day took place at the Center for Computer Research in Music and Acoustics (CCRMA) at Stanford University on May 20th, 2023. It aimed at: giving an overview of the most recent developments in the Faust programming language, giving an introductory tutorial for those who never used Faust.","title":"Faust Day 2023"},{"location":"community/events/#where-is-faust-going-as-a-programming-language-yann-orlarey","text":"","title":"Where is Faust Going as a Programming Language? -- Yann Orlarey"},{"location":"community/events/#overview-of-recent-developments-in-the-faust-general-ecosystem-stephane-letz","text":"","title":"Overview of Recent Developments in the Faust General Ecosystem -- St\u00e9phane Letz"},{"location":"community/events/#faust-and-ai-david-braun","text":"","title":"Faust and AI -- David Braun"},{"location":"community/events/#faust-in-real-time-expressive-virtual-musical-instruments-julius-o-smith","text":"","title":"Faust in Real-Time Expressive Virtual Musical Instruments -- Julius O. Smith"},{"location":"community/events/#real-time-audio-dsp-with-faust-and-fpgas-romain-michon","text":"","title":"Real-Time Audio DSP With Faust and FPGAs -- Romain Michon"},{"location":"community/events/#faust-physical-modeling-workshop","text":"Faust has been used for the physical modeling of musical instruments for many years now. Different tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day online workshop which took place on Feb. 1, 2021 was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques.","title":"Faust Physical Modeling Workshop"},{"location":"community/events/#creating-circuit-bendable-wave-digital-models-of-analog-audio-circuits-in-faust-dirk-roosenburg","text":"Download this workshop's code here Wave-digital models are a well researched and popular approach for creating virtual-analog models of audio circuits for use in audio processing. wdmodels.lib is a new addition to the Faust Libraries that supports easy creation of these models in Faust. In this workshop, we will introduce the technique of wave-digital modeling of circuits by analyzing several audio circuits and exploring their implementation in wdmodels.lib . We also will discuss library support of more complex implementation tasks associated with wave-digital models, such as R-type adaptors and Multiple/Multiport non-linearities. Finally, we will conclude by exploring the capacity of Faust to \"circuit-bend\" our wave-digital models. Note : the workshop's code has been adapted to work with the latest version of the wdmodels.lib library embedded in the Faust Web IDE. You'll see some tiny syntax differences between the video and the new syntax.","title":"Creating Circuit-Bendable Wave-Digital Models of Analog Audio Circuits in Faust -- Dirk Roosenburg"},{"location":"community/events/#an-introduction-to-mass-interaction-modelling-in-faust-james-leonard-and-jerome-villeneuve","text":"Download this workshop's code here This workshop proposes an introduction to mass-interaction (sometimes referred to as mass-spring) modelling for sound synthesis in the Faust environment. After a brief historic introduction to this field, we will give a hands on tutorial on the mi_faust library, which allows simulating modular physical constructions in Faust, as well as online model scripting tools that allow for efficient model design and code generation. We will conclude with ongoing developments and perspectives, in particular regarding performance issues, possible extensions to 3-DoF physics, and the importance of modelling frameworks that allow for a creative approach to physical model design.","title":"An Introduction to Mass-Interaction Modelling in Faust -- James Leonard and J\u00e9r\u00f4me Villeneuve"},{"location":"community/events/#finite-difference-schemes-synthesis-in-faust-riccardo-russo","text":"Download this workshop's code here Over the years, Faust proved to be a powerful tool for developing physical modeling synthesis. However, coding finite difference schemes models has always been complicated, in fact, their implementation in imperative programming languages is typically achieved using data structures, which are not available in Faust. This workshop will introduce the fds library, a new tool which allows to code linear, explicit finite difference schemes physical models in Faust, based on a cellular automata formalism. We will start with a brief introduction on how finite difference schemes work and what is their place within the scope physical modeling techniques. Then, we will focus on how to implement the algorithms we obtained on paper in Faust and, lastly, we will see how the fds library can be used to code such algorithms in a much easier way. By the end of the tutorial you should have quite an understanding on the basic principles of finite difference schemes, on the roles of the different functions inside the fds library and on how they can be used to easily obtain a working fds physical model.","title":"Finite Difference Schemes Synthesis in Faust -- Riccardo Russo"},{"location":"community/events/#break","text":"","title":"break"},{"location":"community/events/#introduction-to-the-faust-physical-modeling-toolkit-romain-michon","text":"Download this workshop's code here A series of tools to facilitate the implementation of waveguide and modal physical models of musical instruments have been developed over the years by the Faust team to become the \"Faust Physical Modeling Toolkit.\" This comprises the Faust Physical Modeling library ( pm.lib ) as well as mesh2faust , a tool to convert 3D meshes into modal physical models compatible with pm.lib . During this workshop, we will provide a step-by-step tutorial on how to use these different tools to implement various kinds of physical models from scratch.","title":"Introduction to the Faust Physical Modeling Toolkit -- Romain Michon"},{"location":"community/events/#overview-of-physical-modeling-formulations-and-faust-implementations-julius-o-smith","text":"Download this workshop's code is available at https://ccrma.stanford.edu/~jos/aspf/Appendix_A_State_Space_Models.html#code:statespace and https://ccrma.stanford.edu/~jos/aspf/State_Space_BiQuad_FAUST.html#code:statespaceBiquad A summary of methods for physical modeling is followed by some examples in Faust. Physical models normally start out as differential equations which are then digitized to yield finite-difference schemes as were discussed earlier in this workshop. Wave digital and digital waveguide formulations were also discussed. Two additional topics are state-space models and modal representations which can be obtained by diagonalizing state-space models. As a result, this talk focuses primarily on state-space models and how to diagonalize them.","title":"Overview of Physical Modeling Formulations and Faust Implementations -- Julius O. Smith"},{"location":"community/help/","text":"Getting Help Faust Mailing Lists Mailing lists are the oldest way to reach out to the Faust community. If you have a question about the Faust language, the use of one of its associated tools (e.g., FaustLive, the web editor, etc.), or if you just want to follow the latest Faust news, please subscribe and ask your question to: the Faust Users Mailing List If you'd like to follow the development of Faust and of its associated tools and/or if you wish to contribute to it, please subscribe and ask your question to: the Faust Developers Mailing List Faust on discord Connect to the Faust discord server. The Audio Programmer community discord community has a #faust channel. Faust slack channel Slack can also be used to get help with Faust: https://faustaudio.slack.com or this link , but Faust on discord is the preferably way to go. Faust GitHub discussion The discussions can also take place on the Faust GitHub discussion forum .","title":"Getting Help"},{"location":"community/help/#getting-help","text":"","title":"Getting Help"},{"location":"community/help/#faust-mailing-lists","text":"Mailing lists are the oldest way to reach out to the Faust community. If you have a question about the Faust language, the use of one of its associated tools (e.g., FaustLive, the web editor, etc.), or if you just want to follow the latest Faust news, please subscribe and ask your question to: the Faust Users Mailing List If you'd like to follow the development of Faust and of its associated tools and/or if you wish to contribute to it, please subscribe and ask your question to: the Faust Developers Mailing List","title":"Faust Mailing Lists"},{"location":"community/help/#faust-on-discord","text":"Connect to the Faust discord server. The Audio Programmer community discord community has a #faust channel.","title":"Faust on discord"},{"location":"community/help/#faust-slack-channel","text":"Slack can also be used to get help with Faust: https://faustaudio.slack.com or this link , but Faust on discord is the preferably way to go.","title":"Faust slack channel"},{"location":"community/help/#faust-github-discussion","text":"The discussions can also take place on the Faust GitHub discussion forum .","title":"Faust GitHub discussion"},{"location":"community/ifc/","text":"International Faust Conference (IFC) The International Faust Conference (IFC) takes place every two year. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants share their work through paper presentations. A series of round tables on various topics serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops are usually available for participants to openly share their ongoing projects with the rest of the community. Next Edition: IFC-24 - November 21-22, 2024 - Before SoundMit 24 at Turin (Italy) The fourth edition of the International Faust Conference ( IFC-24 ) will take place just before SoundMit 24 on November 21-22, 2024 at Turin (Italy). Past Editions IFC-22 - June 7-8, 2022 - During SMC-22 at St-Etienne (France) The third edition of the International Faust Conference (IFC-22) took place during SMC-22 at St-Etienne (France) on June 7-8, 2022, with morning recording and afternoon recording . IFC-20 - MSH Paris Nord Saint-Denis (France) The second edition of the International Faust Conference (IFC-20) took place at the Maison des Sciences de l\u2019Homme Paris Nord on December 1-2, 2020. IFC-18 - JGU, Mainz (Germany) The first edition of the International Faust Conference (IFC-18) took place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018.","title":"Faust Conference"},{"location":"community/ifc/#international-faust-conference-ifc","text":"The International Faust Conference (IFC) takes place every two year. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants share their work through paper presentations. A series of round tables on various topics serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops are usually available for participants to openly share their ongoing projects with the rest of the community.","title":"International Faust Conference (IFC)"},{"location":"community/ifc/#next-edition-ifc-24-november-21-22-2024-before-soundmit-24-at-turin-italy","text":"The fourth edition of the International Faust Conference ( IFC-24 ) will take place just before SoundMit 24 on November 21-22, 2024 at Turin (Italy).","title":"Next Edition: IFC-24 - November 21-22, 2024 - Before SoundMit 24 at Turin (Italy)"},{"location":"community/ifc/#past-editions","text":"","title":"Past Editions"},{"location":"community/ifc/#ifc-22-june-7-8-2022-during-smc-22-at-st-etienne-france","text":"The third edition of the International Faust Conference (IFC-22) took place during SMC-22 at St-Etienne (France) on June 7-8, 2022, with morning recording and afternoon recording .","title":"IFC-22 - June 7-8, 2022 - During SMC-22 at St-Etienne (France)"},{"location":"community/ifc/#ifc-20-msh-paris-nord-saint-denis-france","text":"The second edition of the International Faust Conference (IFC-20) took place at the Maison des Sciences de l\u2019Homme Paris Nord on December 1-2, 2020.","title":"IFC-20 - MSH Paris Nord Saint-Denis (France)"},{"location":"community/ifc/#ifc-18-jgu-mainz-germany","text":"The first edition of the International Faust Conference (IFC-18) took place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018.","title":"IFC-18 - JGU, Mainz (Germany)"},{"location":"community/learning/","text":"Learning Faust Faust Kadenze Course In 2018, Yann Orlarey and Romain Michon shot an online course on the Kadenze platform on Real Time Audio Signal Processing in Faust . The videos of this course are free to watch online . Center for Computer Research in Music and Acoustics (CCRMA) Several courses on Faust are given at CCRMA: Julius Smith's Faust tutorial , Writing a Slew Limiter in the Faust Language and Make an Eight Channel Mixer in the Faust IDE Romain Michon's Faust tutorials Music 250a (Physical Interaction Design for Music) course which hosts various tutorials on Faust and hardware Music 250a 2021 and related videos Music 320c (Audio Plugin Development in Faust and C++) Embedded DSP With Faust Workshop TU Berlin The regular sound synthesis class at the Audio Communication Group, TU Berlin, makes use of Faust for exploring the basics of different synthesis algorithms. Student projects based on Faust include Eurorack modules, standalone drum machines and synthesizers, as well as data sonification approaches. The class is taught by Henrik von Coler , who is director of the Electronic Studio at the TU, with a Building Instruments in Faust course. HPI Potsdam The class Data Sonification & Opportunities of Sound at Hasso Plattner Institute, University of Potsdam Potsdam, is an interdisciplinary format, exploring the use of sonification and sound synthesis in the context of design thinking, neurosience and medical applications. The signal processing part is taught by Henrik von Coler . Universit\u00e9 Paris 8 A 24 hours introduction to Faust is given by Alain Bonardi during the first semester to undergraduated students (L3, 3rd year after the french 'baccalaur\u00e9at') in the framework of the course \"Programming Languages in Computer Music 1\" offered in the \"Music creation with computerqs\" minor. Universidad Nacional de Quilmes Cursos de Faust / DSP en espan\u0303ol, realizados por Juan Ramos . Incluyen las clases del \"Seminario de Actualizacio\u0301n en Sonido, Ciencia y Tecnologi\u0301a II\", dictado en la Universidad Nacional de Quilmes (Argentina) en 2021. Faust / DSP courses in Spanish, prepared by Juan Ramos . They include the classes of the \"Update Seminar on Sound, Science and Technology II\", held at the National University of Quilmes (Argentina) in 2021: An intro video is available here All available classes are located here Professional Masters of RIM & RAN The Professional RIM & RAN Masters are aimed at developing students applied knowledge and understanding of electronic and digital technologies for the creation, prepare them to the professions of Producer in Computer Music (RIM - R\u00e9alisateur en Informatique Musicale) and in Digital Arts (RAN - R\u00e9alisateur en Arts Num\u00e9riques) . These producers are direct actors in musical and artistic productions, and work at the interface between software developers, applied computer scientists, composers, artists, etc. and all people likely to integrate video, image and sound in their activities. Most of the courses concerning signal processing are given around the Faust language (M1 Romain Michon 12h / M2 Yann Orlarey 20h). Johannes Gutenberg University of Mainz To complete...","title":"Learning Faust"},{"location":"community/learning/#learning-faust","text":"","title":"Learning Faust"},{"location":"community/learning/#faust-kadenze-course","text":"In 2018, Yann Orlarey and Romain Michon shot an online course on the Kadenze platform on Real Time Audio Signal Processing in Faust . The videos of this course are free to watch online .","title":"Faust Kadenze Course"},{"location":"community/learning/#center-for-computer-research-in-music-and-acoustics-ccrma","text":"Several courses on Faust are given at CCRMA: Julius Smith's Faust tutorial , Writing a Slew Limiter in the Faust Language and Make an Eight Channel Mixer in the Faust IDE Romain Michon's Faust tutorials Music 250a (Physical Interaction Design for Music) course which hosts various tutorials on Faust and hardware Music 250a 2021 and related videos Music 320c (Audio Plugin Development in Faust and C++) Embedded DSP With Faust Workshop","title":"Center for Computer Research in Music and Acoustics (CCRMA)"},{"location":"community/learning/#tu-berlin","text":"The regular sound synthesis class at the Audio Communication Group, TU Berlin, makes use of Faust for exploring the basics of different synthesis algorithms. Student projects based on Faust include Eurorack modules, standalone drum machines and synthesizers, as well as data sonification approaches. The class is taught by Henrik von Coler , who is director of the Electronic Studio at the TU, with a Building Instruments in Faust course.","title":"TU Berlin"},{"location":"community/learning/#hpi-potsdam","text":"The class Data Sonification & Opportunities of Sound at Hasso Plattner Institute, University of Potsdam Potsdam, is an interdisciplinary format, exploring the use of sonification and sound synthesis in the context of design thinking, neurosience and medical applications. The signal processing part is taught by Henrik von Coler .","title":"HPI Potsdam"},{"location":"community/learning/#universite-paris-8","text":"A 24 hours introduction to Faust is given by Alain Bonardi during the first semester to undergraduated students (L3, 3rd year after the french 'baccalaur\u00e9at') in the framework of the course \"Programming Languages in Computer Music 1\" offered in the \"Music creation with computerqs\" minor.","title":"Universit\u00e9 Paris 8"},{"location":"community/learning/#universidad-nacional-de-quilmes","text":"Cursos de Faust / DSP en espan\u0303ol, realizados por Juan Ramos . Incluyen las clases del \"Seminario de Actualizacio\u0301n en Sonido, Ciencia y Tecnologi\u0301a II\", dictado en la Universidad Nacional de Quilmes (Argentina) en 2021. Faust / DSP courses in Spanish, prepared by Juan Ramos . They include the classes of the \"Update Seminar on Sound, Science and Technology II\", held at the National University of Quilmes (Argentina) in 2021: An intro video is available here All available classes are located here","title":"Universidad Nacional de Quilmes"},{"location":"community/learning/#professional-masters-of-rim-ran","text":"The Professional RIM & RAN Masters are aimed at developing students applied knowledge and understanding of electronic and digital technologies for the creation, prepare them to the professions of Producer in Computer Music (RIM - R\u00e9alisateur en Informatique Musicale) and in Digital Arts (RAN - R\u00e9alisateur en Arts Num\u00e9riques) . These producers are direct actors in musical and artistic productions, and work at the interface between software developers, applied computer scientists, composers, artists, etc. and all people likely to integrate video, image and sound in their activities. Most of the courses concerning signal processing are given around the Faust language (M1 Romain Michon 12h / M2 Yann Orlarey 20h).","title":"Professional Masters of RIM &amp; RAN"},{"location":"community/learning/#johannes-gutenberg-university-of-mainz","text":"To complete...","title":"Johannes Gutenberg University of Mainz"},{"location":"community/logos/","text":"Faust Logos The Faust logo is available in several variants (Full Logo, Simple Logo, Faust Award, and Made with Faust). The Adobe Illustrator file is available here Full Logo Very nice and trendy on your T-shirt... Blue White Grey Orange Simple Logo If you don't have too much space... Blue White Grey Orange Faust Awards And the winner is... Blue White Grey Orange Made with Faust For your next killer app... Blue White Grey Orange","title":"Logos"},{"location":"community/logos/#faust-logos","text":"The Faust logo is available in several variants (Full Logo, Simple Logo, Faust Award, and Made with Faust). The Adobe Illustrator file is available here","title":"Faust Logos"},{"location":"community/logos/#full-logo","text":"Very nice and trendy on your T-shirt...","title":"Full Logo"},{"location":"community/logos/#blue","text":"","title":"Blue"},{"location":"community/logos/#white","text":"","title":"White"},{"location":"community/logos/#grey","text":"","title":"Grey"},{"location":"community/logos/#orange","text":"","title":"Orange"},{"location":"community/logos/#simple-logo","text":"If you don't have too much space...","title":"Simple Logo"},{"location":"community/logos/#blue_1","text":"","title":"Blue"},{"location":"community/logos/#white_1","text":"","title":"White"},{"location":"community/logos/#grey_1","text":"","title":"Grey"},{"location":"community/logos/#orange_1","text":"","title":"Orange"},{"location":"community/logos/#faust-awards","text":"And the winner is...","title":"Faust Awards"},{"location":"community/logos/#blue_2","text":"","title":"Blue"},{"location":"community/logos/#white_2","text":"","title":"White"},{"location":"community/logos/#grey_2","text":"","title":"Grey"},{"location":"community/logos/#orange_2","text":"","title":"Orange"},{"location":"community/logos/#made-with-faust","text":"For your next killer app...","title":"Made with Faust"},{"location":"community/logos/#blue_3","text":"","title":"Blue"},{"location":"community/logos/#white_3","text":"","title":"White"},{"location":"community/logos/#grey_3","text":"","title":"Grey"},{"location":"community/logos/#orange_3","text":"","title":"Orange"},{"location":"community/news/","text":"Faust News 2018-07-23: Faust's Evolution View the evolution of the Faust project from 2004 to 2018. The visualization was done using Gource . Here is the command used (as suggested by fullybacked ): gource --hide dirnames,filenames --seconds-per-day 0.1 --auto-skip-seconds 1 -1920x1024 -o - | ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i - -vcodec libx264 -preset ultrafast -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 faust-hd.mp4 2018-07-23: Faust Award 2018 The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale. Faust Award 2018 to iPlug 2 The Faust Award 2018 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to iPlug 2 a free open source C++ audio plug-in framework, allowing developers to create audio plug-ins and apps across a wide range of formats from the same code, including graphical user interface and DSP components. Amongst many other new features and a reworked code base, version 2 includes support for FAUST, allowing sections of audio DSP to be implemented using the FAUST language, and easily integrated with other C++ elements. iPlug 2 is developed by Oliver Larkin and Alex Harker from the original iPlug, by Cockos inc. that was open sourced in 2008. The project is under active development and will be publicly released at the end of 2018. The jury praised the quality, the ambition, and the usefulness of iPlug 2 as a Faust development framework! Check the demo here . We hope that the Faust Award will help the authors to fully finalize the project. Faust Student Software Competition to Cloud Generator In parallel to the main competition, the Faust Student Software Competition , is intended to promote small, but innovative Faust applications, typically developed in the framework of student projects. The student prize 2018 was awarded to Cloud Generator a nine-voice polyphonic synthesizer developed by Rittik Wystup. The jury praised the audio quality and the care taken by Rittik Wystup in his project! Check the Cloud Generator demo here . 2018-07-10: IFC 2018 International Faust Conference IFC18 : July 17-18, 2018 The International Faust Conference IFC18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC18 . IFC-18 is free and everyone is welcome to attend! Please register here -- 2018-02-18: Faust Award 2018 Faust Award 2018: deadline June 1, 2018 The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools built around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 17, 2018 during the International Faust Conference in Mainz IFC18 . To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc. Junior Competition In parallel to the Faust Open-Source Software Competition we have a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count. Important dates Start of the competition: February 18, 2018 Software Submission Deadline: June 1, 2018 Results of the competition: July 17, 2018 Submission Guidelines Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition. International Committee Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA) Previous Winners 2015: Guitarix , by Hermann Meyer and Andreas Degert 2016: Ambitools , by Pierre Lecomte; Student prize: TouchVoices , by Pierre-Adrien Th\u00e9o. 2017-12-12: WebAudio wasm... WebAudio wasm benchmark pages and tools WebAudio wasm benchmark pages and tools allow to test statically generated HTML pages from Faust DSP. Audio generating pages in ScriptProcessor or AudioWorklet mode can be tested first. DSP CPU benchmark pages can be used to test the perfomance of wasm code across different browsers. Tools to generate new DSP CPU benchmark pages are also available, and finally a page allowing to test the dynamic compilation chain can be acccesed. Simple pages Simple pages can be used to test simple monophonic and polyphonic DSP, generated as ScriptProcessor or AudioWorklet WebAudio nodes. statically generated OSC as a ScriptProcessor node statically generated MIDI controllable Organ as a ScriptProcessor node Note that as 12/12/17, AudioWorklet pages can ony be tested with Chrome Canary. Be sure to activate AudioWorklet mode first. On a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7, we still hear audio glitches when testing them , for example when opening the JavaScript console, or interacting with other applications (like scrolling in the XCode editor, scrolling in the terminal...) statically generated OSC as an AudioWorlet node statically generated MIDI controllable Organ as an AudioWorlet node Polyphonic MIDI aware pages More complex statically generated polyphonic MIDI aware pages can be tested. ScriptProcessor based pages: modules/clarinetMIDI.html modules/elecGuitarMIDI.html modules/violinMIDI.html AudioWorklet based pages: modules-worklet/clarinetMIDI.html modules-worklet/elecGuitarMIDI.html modules-worklet/violinMIDI.html Benchmark pages A set of statically generated pages allow to measure the DSP CPU use of Faust generated WebAssemby code. The compute method is repeatedly called in a loop (taking 100% of a core) which duration is measured. Results as MBytes/sec as well a DSP CPU load in % of a 1024 frames, 44.1 kHz audio buffer are displayed. On the following pages, just hit the Start benchmark button, and wait for the result to be displayed. Note that since the computation is done in the main JavaScript thread, don't disturb your machine too much to get a reliable result. The pages can typically be used to compare the performances of different browsers: bench/clarinetMIDI.html bench/djembe.html bench/filterBank.html bench/freeverb.html bench/frenchBell.html bench/guitarEffectChain.html bench/karplus.html bench/karplus32.html bench/kisana.html bench/spectralLevel.html bench/stunedBar6.html bench/violinMIDI.html bench/zitaRev.html Testing the denormal issue A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. Even with the software FTZ mode, we still see huge DSP CPU issue in some cases like this djembe physical model based on simple biquad filters: modules/djembe.html On OSX for instance, open the Activity Monitor tool and look as your browser CPU use. Then hit the checkbox to start playing, and hit it again to stop it. Silence should be produced, but actually very small sample values (= subnormals) are generated. If your machine uses an Intel CPU, you will see CPU raise quite rapidly ! (tested on a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7). Benchmark tools For developers, benchmark tools allow to generate HTML pages to test your DSP. Look in particular at the faust2benchwasm script. Dynamic compilation chain testing page A more complete testing page for monophonic and polyphonic MIDI aware DSP, ScriptProcessor or AudioWorklet mode, FTZ selection mode is available here . 2017-11-07: 1st IFC 1st International Faust Conference - Johannes Gutenberg University, Mainz (Germany), July 17-18, 2018 The International Faust Conference IFC-18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC-18. IFC-18 is free and everyone is welcome to attend! Call for Papers We welcome submissions from academic, professional, independent programmers, artists, etc. We solicit original papers centered around the Faust programming language in the following categories: Original research Technology tutorial Artistic project report (e.g., installation, composition, etc.) Paper should be up to 14 pages in length, non anonymous, and formatted according to this template . Submissions should be carried out via our EasyChair portal . All submissions are subject to peer review. Acceptance may be conditional upon changes being made to the paper as directed by reviewers. Accepted papers will be published on-line as well as in the IFC-18 proceedings paper version. They will be presented by their author(s) at IFC-18 as 15 minutes presentations (+ 5 minutes for questions). Feel free to contact us if you have any question. Important Dates Papers submission deadline: March 2, 2018 Notification of Acceptance: May 1, 2018 Camera-Ready Version: June 1, 2018 Call for Round Table Topics A series of round tables on the following themes will take place both afternoons of IFC-18: Faust Tools (e.g., Architectures, IDE, Faust Code Generator, On-Line Services, etc.) DSP in Faust and Faust Libraries (e.g., New Algorithms, New Libraries, Missing Functions, etc.) Faust Compiler and Semantics Other Topics/Open Session We solicit topic suggestions from the Faust community for each of these themes. Topics can be submitted by means of this Google form . They will be introduced during the round tables by the session chair. Contact Please, address your questions to: ifc18@muwiinfa.geschichte.uni-mainz.de Conference website: http://www.ifc18.uni-mainz.de 2017-10-20: New Editor New Faust Editor We are very happy to announce the online Faust Editor . It can be used to edit , compile and run Faust code from any recent Web Browser with WebAssembly support. This editor works completely on the client side and it is therefore very convenient for situations with many simultaneous users (workshops, classrooms, etc.). It embeds the latest version of the Faust compiler with an efficient WebAssembly backend and offers polyphonic MIDI support. Features The editor engine is based on codemirror . It offers syntax highlighting , auto completion and direct access to the online documentation . The documentation command (ctrl-d) uses the function name at the cursor position to locate to the relevant information. Recommended Browsers The recommended browsers are the latest versions of Firefox and Chrome. Chrome is recommended for MIDI, but it requires an https connexion to use the audio inputs. On the other hand MIDI is not supported by Firefox. Useful links Editor : the official link, https://grame-cncm.github.io/fausteditorweb/ : an alternative link on GitHub. Because this is an https address, audio inputs will work (but not the export function), https://github.com/grame-cncm/fausteditorweb : the GitHub repository. 2017-09-15: Performances... Performances of audio DSP code compiled in WebAssembly Porting and running large C/C++ code base on the Web have been the subject of several competing projects in the recent years, from Google NaCl/PNaCl to Mozilla asm.js . Recently standardized WebAssembly language inherits from ideas experimented in both approaches, with the Mozilla vision finnally winning as Robert O'Callahan explains here . Coupled with the WebAudio API , running real-time audio code in the Web now appears to be an achievable goal. WebAssembly is a hot topic in the JavaScript ecosystem. The WebAudio community is eagerly waiting for the AudioWorklet specification, with its promised reduced latency and glitch-free audio rendering, to land in browser development versions, and be tested. Porting well established C/C++ codebase with Emscripten , like the Csound framework as an example, or using DSL languages like Faust, will then naturally beneficiate from improved and more stable performances. The Faust ecosystem already allows to generate static or dynamically compiled WebAssembly based WebAudio nodes . These nodes are still using the deprecated ScriptProcessor WebAudio interface. Premillinary work has been started to be ready as soon at the AudioWorklet model will be testable. In the meantime, work have been started using the WAVM , a standalone VM for WebAssembly, that can load both the standard binary and text wasm format, compiling it in native code using the LLVM chain (generating LLVM IR and compiling it on the fly to native code using LLVM JIT compiler), and running it at (near) native speed. Glue code to load and run Faust generated wasm modules has been written. Validation and benchmarking tools have been developed. Performances comparison with the C++ and LLVM IR Faust backends is the subject of this post. Comparing the Faust C++, LLVM IR and wast/wasm backends The WebAssembly approach promises near native performances for C/C++ written code compiled to WebAssembly using the Emscripten tool chain. Other languages like Rust (using the mir2wasm tool) experiment direct WebAssembly generation. It seems clear that as WebAssembly specification and implementation stabilize, more and more languages will directly generate wasm to be deployed in browsers. The question of the quality of code generation at each step of the compilation chain will rapidly emerge. While WebAssembly is initially designed to run on the Web, it may be deployed in non Web environnement like nodejs , or even in standalone VM like WAVM . Thus WebAssembly becomes a portable binary format that can be used in a large variety of situations. This is especially of interest for a DSL language like Faust. Faust wast/wasm backend Faust wast/wasm backend directly produce WebAssembly code from the Faust internal FIR (Faust Imperative Representation) code. Generated modules are rather light since they define a very simple ABI to be used by the loader code. Two generation models have been defined: in monophonic mode the wast/mast module internally allocates a memory block to be used for the DSP state (controllers, delays lines, waveforms...) as well as audio buffers. in polyphonic mode, the memory block will be allocated by the loader environnement. This block will typically be sized to contain all the needed voices for the polyphonic DSP. In both cases, a full description of the DSP state as a JSON string is generated in the module data segment (including memory indexes of all controllers). Loader code will get and decode this JSON description, and use whatever parts of the description it needs to run the DSP code. In particular, control memory zones (corresponding to the UI items like buttons, sliders, bargraph...) can be directly read/written by the wrapper code. Benchmark of C++, LLVM IR and wast/wasm generated code Since Faust already generates C++ or LLVM IR code, the performances of those two backends can be compared with the new wasm one. Using the WAVM C++ written machine allows to deploy the same measuring code . The first benchmark compares the speed of C++, LLVM IR and wasm backends running a set of DSP, running on a MacBook Pro 2,2 GHz Core I7 with OSX El capitan. The same 4.0 version of LLVM toolchain has been used with the three backend. C++ and LLVM IR code has been compiled with the -Ofast optimization flag, the WAVM runtime is the standard version one (without any specific audio optimization, see later): The diagrams clearly shows that the wasm code is still slower than C++ or LLVM IR code, but speed difference is not so high in most cases. Some DSP behaviours need to be understood in more details. Optimizing the WAVM runtime for audio code The WAVM runtime strictly conforms to the WebAssembly specification, thus behaving as a interesting base reference. In the audio domain, the deployed code is usually compiled with specific optimization flags. Since C++ WAVM runtime can be hacked quite easily, we did several changes into the reference implementation to gain some speed: removing the atomic flag in all load/store that are added to pass all spec WebAssembly tests. adding the equivalent of -fast-math compilation flag that have to be done at LLVM IR and JIT (= native) generation steps. and finally simplifying some mathematical operators, using their standard definition instead of the specific WAVM coded ones that strictly implement WebAssembly official semantic (see for instance the definition of f32.min/f32.max operations). Here is the diagram of DSP examples run with reference WAVM runtime, and the three specific optimizations: After generating the LLVM IR code, the WAVM runtime runs a set of LLVM IR to IR optimizations passes. It remains to be tested if adding more optimization passes (especially the auto-vectorizations ones) could help producing even better code. WebAssembly module optimization with Binaryen Binaryen is a compiler and toolchain infrastructure library for WebAssembly , written in C++. We tested the wasm-opt tool at -O3 level on Faust generated wasm modules to estimate which speedup we can expect. The following diagram shows limited gains, with no more than 5% in some of the tested cases: Float denormal handling A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Even if using software ftz is not strictly needed in our benchmark chain (since the C++ WAVM uses the ftz hardware protection mode), we can still compare the speed of the different ftz options. Here is the result of code generated with -ftz from 0 to 2: Comparing three browsers on OSX El Capitan HTML test pages were prepared to compare the performances of the three main browsers on OSX El Capitan. The DSP code is compiled with float denormal protection on (-ftz 2). The generated wasm module compute method is called repeatedly in a timed loop, using successive slices of a big allocated circular audio buffer to avoid cache effects. Here are the results: The fasted one (Chrome for now) can be compared with C++, LLVM IR, WAVM native engines, all compiled with float denormal protection on (-ftz 2): Comments and Conclusion Testing wasm JIT machines inside browsers is not an easy task. The C++ WAVM runtime revealed to be an excellent tool to compare the Faust C++, LLVM IR and wasm backend. Since its code can be easily adapted, one can estimate also what can be expected deploying wasm DSP modules in pure native environments , outside of the browser, where some audio specific optimizations may be considered. Measures done on a set of Faust DSP show that WebAssembly code still run slower than C++ or LLVM IR generated code in most cases, up to almost 66% slower in the less favorable examples. This value will typically be a bit worse when deploying in browsers, since float denormal protection code has to be used . Benchmarks in browser wasm runtime still need to be done to confirm or refine these findings. Comparing the Chrome , Firefox and WebKit browsers on OSX El Capitan shows that Chrome is currently the fastest engine in most cases, with Firefox and WebKit quite similar (with a slight plus for WebKit). Comparing the Chrome browser with native engines shows results from 4,8 times slower (filterBank.dsp), 2,8 times slower (sTunedBar6.dsp) up to much more favorable cases (karplus32.dsp). Note that filterBank.dsp example is a bit of a pathological case, since Chrome is significantly slower than Firefox and WebKit in this case, and filterBank.dsp uses a lot of pow(10, x) code that is rewritten an optimized as exp10(x) with the C++ backend path. 2017-08-18: Faust on the Web Deploying Faust DSP on the Web EDIT : we are at the Web Audio conference 2017, and it appears that the way we currently extend the ScripProcessorNode with Faust code is not the Right Way... Part of the post concerning the exposed API will probably change a bit in the near future... Using latest developments done for the Web (the new WebAssembly backends and libfaust library compiled in WebAssembly with Emscripten), statically and dynamically Faust generated WebAudio nodes can be easily produced and deployed on the Web. Deploying statically compiled Faust WebAudio nodes From a foo.dsp source file, JavaScript and the associated WebAssembly files can be produced with the following script: faust2wasm foo.dsp This will generate a foo.wasm file with the WebAssembly module as binary code, as well as a foo.js wrapper file containing the code needed to turn the Faust DSP in a fully working WebAudio node (using an extended ScriptProcessor node). The name of the Faust DSP code file is used to define the final ScriptProcessorNode constructor name. So for instance if osc.dsp file is compiled, the following faust.createosc function will be generated: /** * Create a 'monophonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createosc = function(context, buffer_size, callback) The resulting object is an extended ScriptProcessorNode, to be used as a regular node (like connected to other WebAudio nodes), but which also adds the Faust specific API as defined in the equivalent C++ generated dsp class (see the architecture/faust/dsp/dsp.h header for more technical details), as well as JavaScript more specific functions. For instance the following ones will have to be used to control the node: var paths = node.getParams(); // get the set of paths to read/write input control parameters Then knowing the path for a given parameter, the following function is used to change the parameter value: node.setParamValue(\"/Oscillator/freq\", 0.6); A full JSON description of the node with the complete UI, can be retrieved with: var json = node.getJSON(); The complete usable API is fully documented in the generated JavaScript file in the Public API to be used to control the WebAudio node section. A simple example Web page A simple Web page using the files generated by faust2wasm on the noise.dsp file can be defined with the following parts: <!-- Load 'faust2wasm' script generated .js file --> <script src=\"noise.js\"></script> A slider to control the noise volume parameter is defined with: <P> Noise volume: <input type=\"range\" oninput=\"changeVolume(event) \"min=\"0\" max=\"1\" value=\"0.5\" step=\"0.01\"/> The WebAudio context is created and the noise slide hander is defined with: var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var noise = null; // Slider handler to change the 'noise' volume function changeVolume(event) { noise.setParamValue(\"/Noise/Volume\", parseFloat(event.target.value)); } A startnoise function which creates the Faust WebAudio node is defined with: function startnoise() { // Create the Faust generated node faust.createnoise(audio_context, 1024, function (node) { noise = node; console.log(noise.getJSON()); // Print paths to be used with 'setParamValue' console.log(noise.getParams()); // Connect it to output as a regular WebAudio node noise.connect(audio_context.destination); }); } An finally the load handler is defined to activate the code: window.addEventListener(\"load\", startnoise); Look at the Noise and OSC online pages for the complete code. Note that pages loading an additional .wasm file cannot directly be loaded in Chrome. You'll have to start a local server (using the python -m SimpleHTTPServer command for instance) and access them with their http:// based URL. Generating Polyphonic WebAudio nodes Assuming that the compiled Faust DSP file is polyphonic ready , a polyphonic ready WebAudio node can be created with the -poly parameter, and will generate the following constructor for the node (where the mydsp part will be replaced by the actual DSP name): /** * Create a 'polyphonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * to be use for the voice, and allocating the number of needed voices * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode * as parameter, or null in case of error */ faust.createmydsp_poly = function(context, buffer_size, polyphony, callback) Polyphonic nodes have an extended API to be controled with MIDI messages: /** * Instantiates a new polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOn = function (channel, pitch, velocity) /** * De-instantiates a polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOff = function (channel, pitch, velocity) /** * Gently terminates all the active voices. */ allNotesOff = function () Look at the JavaScript public documentation section for the complete description. Extended control with -comb parameter The faust2wasm tool can be used with the -comb parameter to compile several DSP files and contatenate all JavaScript code in a unique resulting comb.js file (possibly to be used in -poly mode also). Generating fully working self-contained HTML pages The faust2webaudiowasm script can be used to generate a fully working self-contained HTML page, with a SVG/CSS a Graphical User Interface. From the osc.dsp Faust DSP source file, it will generate an osc.html file: faust2webaudiowasm osc.dsp Assuming that the compiled Faust DSP file is polyphonic ready, the -poly parameter can be used to generate a polyphonic MIDI controlable instrument, to be used with a MIDI application or device. The -links generates the DSP processor SVG representation, and links to the original DSP file as well as generated SVG files, so that the HTML page can possibly be deployed as a reusable Faust DSP resource. WebAssembly module optimization Assuming that you have Binaryen tools installed on your machine, the faust2wasm and faust2webaudiowasm scripts can take an additional -opt parameter to allow WebAssembly module optimization. Deploying dynamically compiled Faust WebAudio nodes Since the libfaust library is available for the Web, it becomes possible to embed the complete dynamic compilation chain in a Web page , from the Faust DSP source to the executable WebAudio node. First the following resources (located on the Faust GitHub in architecture/webaudio folder) have to be loaded in the page: <!-- Load 'libfaust' library and wrapper code --> <script src=\"libfaust-wasm.js\"></script> <script src=\"webaudio-wasm-wrapper.js\"></script> Then the two following functions are used to generate factories, creating later on monophonic or polyphonic instances (this is necessary because of the way internal WebAssembly memory is managed): /** * Create a DSP factory from source code as a string to be used to create monophonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createDSPFactory = function (code, argv, callback) /** * Create a DSP factory from source code as a string to be used to create polyphonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createPolyDSPFactory = function (code, argv, callback) The two following functions are used to generate monophonic or polyphonic Faust WebAudio nodes: /** * Create a ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createDSPInstance = function (factory, context, buffer_size, callback) /** * Create a 'polyphonic' 'ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createPolyDSPInstance = function (factory, context, buffer_size, polyphony, callback) The resulting nodes have the same API as statically compiled nodes described in the first section, so can be controlled the same way, including the polyphonic ones. Here is a code example using faust.createDSPFactory and faust.createDSPInstance : var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var dsp_code = \"import(\\\"stdfaust.lib\\\"); vol = hslider(\\\"volume [unit:dB]\\\", 0, -96, 0, 0.1) : ba.db2linear : si.smoo; freq = hslider(\\\"freq [unit:Hz]\\\", 1000, 20, 24000, 1); process = vgroup(\\\"Oscillator\\\", os.osc(freq) * vol);\"; var osc = null; var libraries_url = \"/modules/libraries/\"; function startosc() { // Prepare argv list var argv = []; argv.push(\"-ftz\"); argv.push(\"2\"); argv.push(\"-I\"); argv.push(libraries_url); // Dynamically create the Faust generated node from explicit DSP source in 'dsp_code' faust.createDSPFactory(dsp_code, argv, function (factory) { faust.createDSPInstance(factory, audio_context, 1024 function (node) { osc = node; console.log(osc.getJSON()); // Print paths to be used with 'setParamValue' console.log(osc.getParams()); // Connect it to output as a regular WebAudio node osc.connect(audio_context.destination); })}); } The Dynamic OSC page demonstrates the dynamic OSC complete code (based on the example seen before). The Dynamic Organ page demonstrates a polyphonic organ instrument, which loads a DSP from an url, and ready to be controlled with a MIDI device or application. Look at the Dynamic Faust compiler page for a more complete use-case of the dynamic compiler. Float denormal handling A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Use for example the following line to active software denormal handing when using faust2wasm tool: faust2wasm -ftz 2 foo.dsp The same for the faust2webaudiowasm tool: faust2webaudiowasm -ftz 2 foo.dsp For dynamic compilation, the -ftz v flag will have to be added in the argv parameter in faust.createDSPFactory or faust.createPolyDSPFactory , like for instance: faust.createPolyFactory(dsp_code, ['-ftz', '2'], callback); 2017-06-16: Memory allocator Using a custom memory allocator From a DSP source file, the Faust compiler typically generates a C++ class. When a rdtable item is used on the source code, the C++ class will contain a table shared by all instances of the class. By default, this table is generated as a static class array, and so allocated in the application global static memory. In some specific case (usually in more constrained deployment cases), managing where this data is allocated is crucial. By extension this post explains how a custom memory allocator can be used to precisely control the DSP memory allocation. Faust -mem option to control memory related code generation A new -mem compiler parameter has been added in the Faust compiler, starting from the 0.9.103 version (or 2.1.4 in Faust2 branch). This parameter will change the way static shared tables are generated. The table is allocated as a class static pointer allocated using a custom memory allocator , which has the following propotype: struct dsp_memory_manager { virtual ~dsp_memory_manager() {} virtual void* allocate(size_t size) = 0; virtual void destroy(void* ptr) = 0; }; Taking the following Faust DSP example: process = (waveform {10,20,30,40,50,60,70}, %(7)~+(3) : rdtable), (waveform {1.1,2.2,3.3,4.4,5.5,6.6,7.7}, %(7)~+(3) : rdtable); Here is the generated code in default mode: ... int mydsp::itbl0[7]; float mydsp::ftbl0[7]; static void classInit(int samplingFreq) { SIG0 sig0; sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; sig1.init(samplingFreq); sig1.fill(7,ftbl0); } virtual void init(int samplingFreq) { classInit(samplingFreq); instanceInit(samplingFreq); } virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are static class arrays. They are filled in the classInit method. The architecture code will typically call the init method (which calls classInit ) on a given DSP, to allocate class related arrays and the DSP itself. If several DSP are going to be allocated, calling classInit only once then the instanceInit method on each allocated DSP is the way to go. In the new -mem mode, the generated C++ code is now: ... int* mydsp::itbl0 = 0; float* mydsp::ftbl0 = 0; dsp_memory_manager* mydsp::fManager = 0; static void classInit(int samplingFreq) { SIG0 sig0; itbl0 = static_cast<int*>(fManager->allocate(sizeof(int) * 7)); sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; ftbl0 = static_cast<float*>(fManager->allocate(sizeof(float) * 7)); sig1.init(samplingFreq); sig1.fill(7,ftbl0); } static void classDestroy() { fManager->destroy(itbl0); fManager->destroy(ftbl0); } virtual void init(int samplingFreq) {} virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are generated a class static pointers. The classInit method takes the additional dsp_memory_manager object used to allocate tables. A new classDestroy method is available to deallocate the tables. Finally the init method is now empty, since the architecure file is supposed to use the classInit/classDestroy method once to allocate and deallocate static tables, and the instanceInit method on each allocated DSP. Control of the DSP memory allocation An architecture file can now define its custom memory manager by subclassing the dsp_memory_manager abstract base class, and implement the two required allocate and destroy methods. Here is an example of a simple heap allocating manager: struct malloc_memory_manager : public dsp_memory_manager { virtual void* allocate(size_t size) { void* res = malloc(size); cout << \"malloc_manager: \" << size << endl; return res; } virtual void destroy(void* ptr) { cout << \"free_manager\" << endl; free(ptr); } }; Controlling the table memory allocation To control table memory allocation, the architecture file will have to do: // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Allocate the dsp instance using regular C++ new mydsp* dsp = new mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Deallocate the dsp instance using regular C++ delete delete dsp; // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy(); Controlling the complete DSP memory allocation Full control the DSP memory allocation can be done using C++ placement new : #include <new> // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Placement new using the custom allocator mydsp* dsp = new(manager.allocate(sizeof(mydsp))) mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Calling the destructor dsp->~mydsp(); // Deallocate the pointer itself using the custom memory allocator manager.destroy(dsp); // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy(); More complex custom memory allocators can be developed by refining this malloc_memory_manager example, possibly defining real-time memory allocators...etc... The OWL architecture file already uses this new custom memory allocator model. This is a work in progress: in the Faust2 branch, this model is still not supported yet beside the C++ backend custom memory allocator is not yet supported is additional DSP classes (like the mydsp_poly defined in the achitecture/faust/dsp/poly-dsp.h header). 2017-04-26: Optimizing... Optimizing the DSP CPU usage The Faust compiler has as lot of different compilation parameters to play with. Discovering them for a given DSP program is something that can be automated. Two measure_dsp and dsp_optimizer classes are available for developers to measure DSP CPU use directly in their code. Two more friendly faustbench and faustbench-llvm tools have been developed using them. They allow to discover the best Faust compiler parameters, to be used later on with faust2xx scripts, faustgen~ Max/MSP external or FaustLive . The measure_dsp and dsp_optimizer DSP decorator classes The measure_dsp class defined in the faust/dsp/dsp-bench.h file allows to decorate a given DSP object and measure its compute method CPU consumption. Results are given in Megabytes/seconds (higher is better). Here is a C++ code example of its use: static void bench(dsp* dsp, const string& name) { // Init the DSP dsp->init(48000); // Wraps it with a 'measure_dsp' decorator measure_dsp mes(dsp, 1024, 5); // Measure the CPU use mes.measure(); // Print the stats cout << name << \" CPU use : \" << mes.getStats() << endl; } Only part of the Faust2 branch and defined in the faust/dsp/dsp-optimizer.h file, the dsp_optimizer class uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. Here is a C++ code example of its use: static void dynamic_bench(const string& dsp_source) { // Init the DSP optimizer with the dsp_source to compile // (either the filename or source code string) dsp_optimizer optimizer(dsp_source, \"/usr/local/share/faust\", \"\", 1024); double value; // Discover the best set of parameters vector<string> options = optimizer.findOptimizedParameters(value); // Print the result cout << \"Best value is for '\" << argv[1] << \"' is : \" << value << \" with \"; for (int i = 0; i < options.size(); i++) { cout << options[i] << \" \"; } cout << endl; } Using the faustbench tool The faustbench tool uses the C++ backend to generate a set of C++ files produced with different Faust compiler options. All files are then compiled in a unique binary that will measure DSP CPU of all versions of the compiled DSP. The tool is supposed to be launched in a terminal, but it can be used to generate an iOS project, ready to be launched and tested in Xcode. Here are the available options: faustbench [-ios] [Additional Faust options (-vec -vs 8...)] <file.dsp> Use '-ios' to generate an iOS project Use 'export CXX=/path/to/compiler' before running faustbench to change the C++ compiler Use 'export CXXFLAGS=options' before running faustbench to change the C++ compiler options Here is a trace of its use: faustbench karplus32.dsp Selected compiler is g++ with CXXFLAGS = -Ofast -scal : 77.5123 -vec -lv 0 -vs 4 : 64.2194 -vec -lv 0 -vs 8 : 80.8951 -vec -lv 0 -vs 16 : 106.244 ..... -vec -lv 1 -vs 128 -g : 130.635 -vec -lv 1 -vs 256 -g : 134.335 -vec -lv 1 -vs 512 -g : 135.352 Best value is : 136.235 with -vec -lv 0 -vs 512 Using the faustbench-llvm tool Available in the faust2 branch only, the faustbench-llvm tool uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. In the main Faust folder, use make bench && sudo make install to build and install the tool. Here is a trace of its use: faustbench-llvm karplus32.dsp Estimate timing parameters -scal : 21.1269 duration = 0.102801 count = 24318 Discover best parameters option -scal : 21.1034 -vec -lv 0 -vs 4 : 42.0734 -vec -lv 0 -vs 8 : 55.3725 -vec -lv 0 -vs 16 : 85.3855 ..... -vec -lv 1 -vs 128 -dfs : 133.974 -vec -lv 1 -vs 256 -dfs : 139.12 -vec -lv 1 -vs 512 -dfs : 91.8424 Refined with -mcd -vec -lv 0 -vs 256 -g -mcd 2 : 83.5555 -vec -lv 0 -vs 256 -g -mcd 4 : 138.519 -vec -lv 0 -vs 256 -g -mcd 8 : 140.122 -vec -lv 0 -vs 256 -g -mcd 16 : 141.558 -vec -lv 0 -vs 256 -g -mcd 32 : 139.454 -vec -lv 0 -vs 256 -g -mcd 64 : 143.405 -vec -lv 0 -vs 256 -g -mcd 128 : 142.975 -vec -lv 0 -vs 256 -g -mcd 256 : 139.345 Best value is for 'karplus32.dsp' is : 142.473 with -vec -lv 0 -vs 256 -dfs -mcd 64 w 2017-02-21: Faust meets JUCE JUCE is an open-source cross-platform C++ application framework, used for the development of desktop and mobile applications. JUCE is used in particular for its GUI and plugins libraries. A set of architecture files have been developed to deploy standalone or plugins built from Faust code. They allow to automatically generate the GUI from the Faust program, possibly supporting polyphonic instruments, and be controlled by MIDI or OSC messages. The architecture files are then combined to produce ready to compile JUCE applications or plugins, using tools that are part of the Faust distribution. They can also be accessed using the Faust online compiler. faust2juce script faust2juce transforms a Faust DSP program into a fully working JUCE standalone application or plugin, which can possibly be controlled with MIDI or OSC messages. Read its complete description here . You'll have to get a recent github version of Faust tree to use it. Using the online compiler The Faust online compiler has been updated to provide new 'juce' targets. Note that only some of the possible compilation options are availble for now: the application target produces a standalone MIDI controlable application (using Faust polyphonic code if the Faust source code is polyphonic aware) the plug-in target produces a MIDI controlable mono or polyphonic plugin (using Faust polyphonic code if the Faust source code is polyphonic aware) the jsynth target produces a MIDI controlable mono or polyphonic plugin (using JUCE polyphonic Synthesizer if the Faust source code is polyphonic aware) Directly using faust2juce provides the full control of the generated target with access to all possible compilation parameters. Graph of Faust generated plugins Here is an example of three Faust generated plugins running in JUCE plugin host: Using libfaust and LLVM An alternative to faust2juce static-compilation model, is to use Oliver Larkin's juce_faustllvm module, also used in his pMix2 tool . 2017-01-13: WebAssembly... Faust WebAssembly backend WebAssembly was born with the premise of creating a safe, portable and fast to load and execute format suitable for the web. WebAssembly its not a programing language but a compilation target with a text and binary specs. That means that other low level languages like C/C++, Rust, Swift, etc. can compile to WebAssembly. Specified and developed by principal browser compagnies (Google, Mozilla, Microsoft and Apple), this new format aims to finally replace the more hackish \"asm.js\" format initialy developed by Mozilla. Development versions of Chrome and Firefox can already execute it. To get an early preview of this experimental technology, at your own risk: on Chrome Canary , open chrome://flags/#enable-webassembly and enable the switch on Firefox Nightly , open about:config and set javascript.options.wasm to true See a preview of Microsoft Edge support and follow Safari support on WebKit\u2019s feature status . WebAssembly backends New WebAssembly backends have been added in the faust2 development branch. They allow to generate textual or binary WebAssembly code. 'wast' textual backend The 'wast' backend allows to generate textual WebAssembly code (in s-expression like format). Note that as of january 2017, the official textual format is not yet fully specified, thus we follow the format used in the binaryen tool . Use the following command to generate the textual output in the terminal for a given foo.dsp file. faust -lang wast foo.dsp The following command: faust -lang wast foo.dsp -o foo.wast will generate the foo.wast textual WebAssembly output file as well as an additional foo.js JavaScript file containing glue code. 'wasm' binary backend The 'wasm' backend allows to generate binary WebAssembly code. Use the following command to generate the binary output in the terminal for a given foo.dsp file. faust -lang wasm foo.dsp The following command: faust -lang wasm foo.dsp -o foo.wasm will generate the foo.wast binary WebAssembly output file as well as an additional foo.js JavaScript file containing glue code. Generating static HTML pages WebAssembly code can be feeded into WebAudio JavaScript nodes, which can then be used like any other native WebAudio node. Two scripts are available to generate static WebAudio html pages from a given foo.dsp source file with the generated html/css/svg user interface: faust2webaudiowast foo.dsp will generate the textual WebAssembly output, use binaryen wasm-as tool to convert the wast to wasm format (you'll have to compile and install the binaryen tools on your machine), and produce a self-contained html page. faust2webaudiowasm foo.dsp will generate the binary WebAssembly output that can directly be loaded by the produced self-contained html page. Page containing polyphonic instruments can be generated with the following commands: faust2webaudiowast -poly foo.dsp to use the 'wast' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument. faust2webaudiowasm -poly foo.dsp to use the 'wasm' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument. 2016-10-17: Faust Award 2016 The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale Faust Award 2016 to Ambitools The Faust Award 2016 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Dave Phillips (musician, journalist, and educator, USA) Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to Ambitools , a set of tools for real-time 3D sound field synthesis using higher order ambisonics (HOA). Ambitools is developed by Pierre Lecomte, a PhD candidate at Conservatoire National des Arts et M\u00e9tiers and Sherbrooke University. The core of the sound processing is written in Faust. The tools contain HOA encoders, decoders, binaural-filters, HOA signals transformations, spherical VU-Meter, etc. and can be compiled in various plug-ins format under Windows, Mac OSX, and Linux. The jury praised the quality and the usefulness of Ambitools: a really useful and technically advanced Faust app and an impressive technical achievement ! Check the demo . The committee was also very impressed by the quality of two other projects : Voice of Faust , a voice synthesizer/effects machine by Bart Brouns ( demo ). PMix , a graphical patcher, preset interpolator and JIT compiler for FAUST by Oliver Larkin ( demo ). Faust Student Software Competition to TouchVoices In parallel to the main competition, we introduced this year a junior competition: the Faust Student Software Competition , intended to promote small but interesting Faust applications, typically written as student projects. The student prize was awarded to TouchVoices (by Pierre-Adrien Th\u00e9o, RIM Master student at University Jean Monnet) a real-time web application allowing to capture, playback and transform sound loops. Here is a video of Pierre-Adrien Th\u00e9o during a performance with TouchVoices . A very close competitor was SuperBeatRepeater (by Vincent Rateau, of SuperDirt fame), a sample accurate beat repeater. Don't miss the demo ! 2016-08-30: FAUST book... The first FAUST book is Korean ! \u201c Sound Programming using FAUST \u201d, written by Jin-Wook Chae , an experienced audio developer and sound engineer (right) and Hyun-Hoo Jung (left), is the very first book ever published on FAUST. While the book is written in Korean, I was able to really appreciate the choice of the examples and the elegance as well as the high quality of the code. I am sure it will be an invaluable tool to promote FAUST in Korea among sound engineering, computer music students and more generally any person interested in sound programming. This book is for people desiring to produce musical instruments or sound processors. I have always been instructing my students that the ultimate importance is to discover interesting ideas about the sound. In spite of that, I have often relied on an unflattering response such as \"you may need to learn a programming language like C/C++...\" when a student asked for help with how to execute his/her ideas related to sound. Now I am pleased to recommend the use of FAUST to bring such ideas into execution. This is an easy self-study guide that can help to do just that. Now I can confidently tell anybody pursuing sound or electronic music that their exciting and brilliant idea about sound is what truly counts! So, really, how do we execute our ideas? Today I am introducing you to FAUST and to this book which you will find immensely helpful in terms of how to use FAUST to bring your fabulous ideas into reality. Jinwook Chae 2016-06-30: Faust interpreter A new 'interpreter' backend has been added in the faust2 development branch. It allows to execute Faust programs without using the LLVM dynamic compiler chain. Interpreter compilation chain The dynamic compilation chain allows developers to embed the Faust compiler technology directly in their application or plugins. Faust2 development branch uses an intermediate FIR representation (Faust Imperative Representation), which can be translated to several output languages. An LLVM backend has been previously developed to allows applications to compile a DSP source into executable code in memory, bypassing the external compiler requirement. In some specific situations, embedding the LLVM chain is not possible : for instance Apple does not allow to deploy dynamic compilers on iOS. Thus having an interpreter backend allows to get around this problem and still make Faust code run on those platforms. Interpreter backend The interpreter backend translates the FIR intermediate language into instructions for a virtual machine. A pure C++ interpreter for this instruction set has been implemented. Running and performances The interpreter backend translates the FIR intermediate language into bytecode for a virtual machine. It allows to run programs about 4 to 5 slower than native speed . Moreover this interpreter can be compiled in a special 'trace' mode to automatically detect various execution errors : invalid heap access, mathematical errors or warnings (division by zero, integer overloading....) which helps us to check the compiler semantic and code generation quality. Deployment for developers Given a Faust source code (as a file or a string), calling the createInterpreterDSPFactoryXXX function runs the compilation chain (Faust + interpreter) and generates the \u201cprototype\u201d of the class, as a interpreter-dsp-factory pointer. class interpreter_dsp_factory : public dsp_factory { public: /* Return Factory name */ std::string getName(); /* Return Factory SHA key */ std::string getSHAKey(); /* Return Factory expanded DSP code */ std::string getDSPCode(); /* Creates a new dsp instance */ dsp* createDSPInstance(); }; Note that the library keeps an internal cache of all allocated factories so that the compilation of the same DSP code, that is same source code and same set of 'normalized' (= sorted in a canonical order) compilations options, will return the same (reference counted) factory pointer. You will have to explicitly use deleteInterpreterDSPFactory to properly decrement the reference counter when the factory is no more needed. You can get a unique SHA1 key of the created factory using its getSHAKey method. Next, the createDSPInstance function, corresponding to the new className of C++, instantiates a interpreter-dsp pointer to be used through its interface, connected to the audio chain and controller interfaces. When finished, simply use delete to destroy the dsp instance. class interpreter_dsp : public dsp { public: void metadata(Meta* m); int getNumInputs(); int getNumOutputs(); void init(int samplingRate); void instanceInit(int samplingRate); dsp* clone(); void buildUserInterface(UI* inter); int getSampleRate(); void compute(int count, FAUSTFLOAT** input, FAUSTFLOAT** output); }; Since interpreter_dsp is a subclass of the dsp base class, an object of this type can be used with all already available audio and UI classes, in essence reusing all architecture files already developed for the static C++ class compilation scheme (like OSCUI, httpdUI interfaces etc.), see Developing a new architecture file . Saving/restoring the factory After the DSP factory has been compiled, your application or plugin may want to save/restore it in order to save Faust to interpreter bytecode compilation at next use. To get the internal factory compiled code, several functions are available: writeInterpreterDSPFactoryToMachine allows to get the interpreter bytecode as a string, writeInterpreterDSPFactoryToMachineFile allows to save the interpreter bytecode in a file, To re-create a DSP factory from a previously saved code, several functions are available: readInterpreterDSPFactoryFromMachine allows to create a DSP factory from a string containing the interpreter bytecode, readInterpreterDSPFactoryFromMachineFile allows to create a DSP factory from a file containing the interpreter bytecode. The complete API is available and documented in the installed faust/dsp/interpreter-dsp.h header. 2016-04-07: Web Audio API Faust and the Web Audio API (3) The Faust compiler can now directly be used in a Web page. Thanks to the Emscripten compiler, the Faust compiler itself can be compiled to asm.js JavaScript. This has been done by compiling the libfaust C++ library to the libfaust.js JavaScript library, that exports a unique entry point. Compiling DSP to JavaScript (asm.js) The libfaust.js exported function createAsmCDSPFactoryFromString(...) allows to create a DSP factory from a given DSP program as a source string and a set of compilations parameters, uses the Faust compiler asm.js backend, and produces the complete asm.js module and additional pure JavaScript methods as a string. Then calling JavaScript 'eval' function on this string compiles it in the browser. The dynamically created asm.js module and additional pure JavaScript methods can then be used. This internal code in then wrapped with additional JavaScript code. A DSP \u201cfactory\u201d will be created from the DSP source code with the following 'synchronous' code (if using the 'libfaust.js' library): var factory = faust.createDSPFactory(code, arguments); or possibly (if using the 'libfaustworker.js' library in the 'asynchronous' model): faust.createDSPFactory(code, arguments, callback); where 'code' is the DSP source as a string, and 'arguments' is an array of parameters to be given to the Faust compiler (like '-vec', '-vs 512'...), and 'callback' is a function taking the created 'factory' as argument. When no more used, you'll have to explicitly use the following code the deallocate the factory: faust.deleteDSPFactory(factory); Your application may want to save the already compiled factory as asm.js/JavaScript code to speed-up possible restore at later time: var machine_code = faust.writeDSPFactoryToMachine(factory); And restore the factory with the following code: var factory = faust.readDSPFactoryFromMachine(machine_code); Using DSP instances A fully working DSP \u201cinstance\u201d as a Web Audio node is then created with the code: var dsp = faust.createDSPInstance(factory, audio_context, buffer_size); When no more used, you'll have to explicitly use the following code to deallocate the instance: faust.deleteDSPInstance(dsp); This instance can be used like the statically compiled one, as previously described in this page . Polyphonic instruments Polyphonic instruments can be produced. For a given 'factory' the following code will create a 16 voices polyphonic instance: var dsp = faust.createPolyDSPInstance(factory, audio_context, buffer_size, 16); This instance can be used like the statically compiled one, as previously described in this page . Using Faust JavaScript library The Emscripten compiled Faust library can be used in two ways. Either using the 'libfaust.js' library: <script src=\"libfaust.js\"></script> <script src=\"webaudio-asm-wrapper.js\"></script> or if using worker mode with the following code which loads the 'libfaustworker.js' library: <script src=\"webaudio/webaudio-asm-worker-wrapper.js\"></script> 2016-02-05: Faust Award 2016 Faust Award 2016: deadline June 1, 2016 The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools build around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 15, 2016. To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc. Junior Competition In parallel to the Faust Open-Source Software Competition we introduce this year a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count. Important dates Start of the competition: February 8, 2016 Software Submission Deadline: June 1, 2016 Results of the competition: July 1, 2016 Submission Guidelines Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition. International Committee Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Dave Phillips (Musician/Journalist, Findlay, USA) Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA) Previous Winners 2015: Guitarix , by Hermann Meyer and Andreas Degert","title":"News up to 2018"},{"location":"community/news/#faust-news","text":"","title":"Faust News"},{"location":"community/news/#2018-07-23-fausts-evolution","text":"View the evolution of the Faust project from 2004 to 2018. The visualization was done using Gource . Here is the command used (as suggested by fullybacked ): gource --hide dirnames,filenames --seconds-per-day 0.1 --auto-skip-seconds 1 -1920x1024 -o - | ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i - -vcodec libx264 -preset ultrafast -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 faust-hd.mp4","title":"2018-07-23: Faust's Evolution"},{"location":"community/news/#2018-07-23-faust-award-2018","text":"The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale.","title":"2018-07-23: Faust Award 2018"},{"location":"community/news/#faust-award-2018-to-iplug-2","text":"The Faust Award 2018 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to iPlug 2 a free open source C++ audio plug-in framework, allowing developers to create audio plug-ins and apps across a wide range of formats from the same code, including graphical user interface and DSP components. Amongst many other new features and a reworked code base, version 2 includes support for FAUST, allowing sections of audio DSP to be implemented using the FAUST language, and easily integrated with other C++ elements. iPlug 2 is developed by Oliver Larkin and Alex Harker from the original iPlug, by Cockos inc. that was open sourced in 2008. The project is under active development and will be publicly released at the end of 2018. The jury praised the quality, the ambition, and the usefulness of iPlug 2 as a Faust development framework! Check the demo here . We hope that the Faust Award will help the authors to fully finalize the project.","title":"Faust Award 2018 to iPlug 2"},{"location":"community/news/#faust-student-software-competition-to-cloud-generator","text":"In parallel to the main competition, the Faust Student Software Competition , is intended to promote small, but innovative Faust applications, typically developed in the framework of student projects. The student prize 2018 was awarded to Cloud Generator a nine-voice polyphonic synthesizer developed by Rittik Wystup. The jury praised the audio quality and the care taken by Rittik Wystup in his project! Check the Cloud Generator demo here .","title":"Faust Student Software Competition to Cloud Generator"},{"location":"community/news/#2018-07-10-ifc-2018","text":"","title":"2018-07-10: IFC 2018"},{"location":"community/news/#international-faust-conference-ifc18-july-17-18-2018","text":"The International Faust Conference IFC18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC18 . IFC-18 is free and everyone is welcome to attend! Please register here --","title":"International Faust Conference IFC18: July 17-18, 2018"},{"location":"community/news/#2018-02-18-faust-award-2018","text":"","title":"2018-02-18: Faust Award 2018"},{"location":"community/news/#faust-award-2018-deadline-june-1-2018","text":"The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools built around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 17, 2018 during the International Faust Conference in Mainz IFC18 . To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc.","title":"Faust Award 2018: deadline June 1, 2018"},{"location":"community/news/#junior-competition","text":"In parallel to the Faust Open-Source Software Competition we have a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count.","title":"Junior Competition"},{"location":"community/news/#important-dates","text":"Start of the competition: February 18, 2018 Software Submission Deadline: June 1, 2018 Results of the competition: July 17, 2018","title":"Important dates"},{"location":"community/news/#submission-guidelines","text":"Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition.","title":"Submission Guidelines"},{"location":"community/news/#international-committee","text":"Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA)","title":"International Committee"},{"location":"community/news/#previous-winners","text":"2015: Guitarix , by Hermann Meyer and Andreas Degert 2016: Ambitools , by Pierre Lecomte; Student prize: TouchVoices , by Pierre-Adrien Th\u00e9o.","title":"Previous Winners"},{"location":"community/news/#2017-12-12-webaudio-wasm","text":"","title":"2017-12-12: WebAudio wasm..."},{"location":"community/news/#webaudio-wasm-benchmark-pages-and-tools","text":"WebAudio wasm benchmark pages and tools allow to test statically generated HTML pages from Faust DSP. Audio generating pages in ScriptProcessor or AudioWorklet mode can be tested first. DSP CPU benchmark pages can be used to test the perfomance of wasm code across different browsers. Tools to generate new DSP CPU benchmark pages are also available, and finally a page allowing to test the dynamic compilation chain can be acccesed.","title":"WebAudio wasm benchmark pages and tools"},{"location":"community/news/#simple-pages","text":"Simple pages can be used to test simple monophonic and polyphonic DSP, generated as ScriptProcessor or AudioWorklet WebAudio nodes. statically generated OSC as a ScriptProcessor node statically generated MIDI controllable Organ as a ScriptProcessor node Note that as 12/12/17, AudioWorklet pages can ony be tested with Chrome Canary. Be sure to activate AudioWorklet mode first. On a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7, we still hear audio glitches when testing them , for example when opening the JavaScript console, or interacting with other applications (like scrolling in the XCode editor, scrolling in the terminal...) statically generated OSC as an AudioWorlet node statically generated MIDI controllable Organ as an AudioWorlet node","title":"Simple pages"},{"location":"community/news/#polyphonic-midi-aware-pages","text":"More complex statically generated polyphonic MIDI aware pages can be tested. ScriptProcessor based pages: modules/clarinetMIDI.html modules/elecGuitarMIDI.html modules/violinMIDI.html AudioWorklet based pages: modules-worklet/clarinetMIDI.html modules-worklet/elecGuitarMIDI.html modules-worklet/violinMIDI.html","title":"Polyphonic MIDI aware pages"},{"location":"community/news/#benchmark-pages","text":"A set of statically generated pages allow to measure the DSP CPU use of Faust generated WebAssemby code. The compute method is repeatedly called in a loop (taking 100% of a core) which duration is measured. Results as MBytes/sec as well a DSP CPU load in % of a 1024 frames, 44.1 kHz audio buffer are displayed. On the following pages, just hit the Start benchmark button, and wait for the result to be displayed. Note that since the computation is done in the main JavaScript thread, don't disturb your machine too much to get a reliable result. The pages can typically be used to compare the performances of different browsers: bench/clarinetMIDI.html bench/djembe.html bench/filterBank.html bench/freeverb.html bench/frenchBell.html bench/guitarEffectChain.html bench/karplus.html bench/karplus32.html bench/kisana.html bench/spectralLevel.html bench/stunedBar6.html bench/violinMIDI.html bench/zitaRev.html","title":"Benchmark pages"},{"location":"community/news/#testing-the-denormal-issue","text":"A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. Even with the software FTZ mode, we still see huge DSP CPU issue in some cases like this djembe physical model based on simple biquad filters: modules/djembe.html On OSX for instance, open the Activity Monitor tool and look as your browser CPU use. Then hit the checkbox to start playing, and hit it again to stop it. Silence should be produced, but actually very small sample values (= subnormals) are generated. If your machine uses an Intel CPU, you will see CPU raise quite rapidly ! (tested on a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7).","title":"Testing the denormal issue"},{"location":"community/news/#benchmark-tools","text":"For developers, benchmark tools allow to generate HTML pages to test your DSP. Look in particular at the faust2benchwasm script.","title":"Benchmark tools"},{"location":"community/news/#dynamic-compilation-chain-testing-page","text":"A more complete testing page for monophonic and polyphonic MIDI aware DSP, ScriptProcessor or AudioWorklet mode, FTZ selection mode is available here .","title":"Dynamic compilation chain testing page"},{"location":"community/news/#2017-11-07-1st-ifc","text":"","title":"2017-11-07: 1st IFC"},{"location":"community/news/#1st-international-faust-conference-johannes-gutenberg-university-mainz-germany-july-17-18-2018","text":"The International Faust Conference IFC-18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC-18. IFC-18 is free and everyone is welcome to attend!","title":"1st International Faust Conference - Johannes Gutenberg University, Mainz (Germany), July 17-18, 2018"},{"location":"community/news/#call-for-papers","text":"We welcome submissions from academic, professional, independent programmers, artists, etc. We solicit original papers centered around the Faust programming language in the following categories: Original research Technology tutorial Artistic project report (e.g., installation, composition, etc.) Paper should be up to 14 pages in length, non anonymous, and formatted according to this template . Submissions should be carried out via our EasyChair portal . All submissions are subject to peer review. Acceptance may be conditional upon changes being made to the paper as directed by reviewers. Accepted papers will be published on-line as well as in the IFC-18 proceedings paper version. They will be presented by their author(s) at IFC-18 as 15 minutes presentations (+ 5 minutes for questions). Feel free to contact us if you have any question.","title":"Call for Papers"},{"location":"community/news/#important-dates_1","text":"Papers submission deadline: March 2, 2018 Notification of Acceptance: May 1, 2018 Camera-Ready Version: June 1, 2018","title":"Important Dates"},{"location":"community/news/#call-for-round-table-topics","text":"A series of round tables on the following themes will take place both afternoons of IFC-18: Faust Tools (e.g., Architectures, IDE, Faust Code Generator, On-Line Services, etc.) DSP in Faust and Faust Libraries (e.g., New Algorithms, New Libraries, Missing Functions, etc.) Faust Compiler and Semantics Other Topics/Open Session We solicit topic suggestions from the Faust community for each of these themes. Topics can be submitted by means of this Google form . They will be introduced during the round tables by the session chair.","title":"Call for Round Table Topics"},{"location":"community/news/#contact","text":"Please, address your questions to: ifc18@muwiinfa.geschichte.uni-mainz.de Conference website: http://www.ifc18.uni-mainz.de","title":"Contact"},{"location":"community/news/#2017-10-20-new-editor","text":"","title":"2017-10-20: New Editor"},{"location":"community/news/#new-faust-editor","text":"We are very happy to announce the online Faust Editor . It can be used to edit , compile and run Faust code from any recent Web Browser with WebAssembly support. This editor works completely on the client side and it is therefore very convenient for situations with many simultaneous users (workshops, classrooms, etc.). It embeds the latest version of the Faust compiler with an efficient WebAssembly backend and offers polyphonic MIDI support.","title":"New Faust Editor"},{"location":"community/news/#features","text":"The editor engine is based on codemirror . It offers syntax highlighting , auto completion and direct access to the online documentation . The documentation command (ctrl-d) uses the function name at the cursor position to locate to the relevant information.","title":"Features"},{"location":"community/news/#recommended-browsers","text":"The recommended browsers are the latest versions of Firefox and Chrome. Chrome is recommended for MIDI, but it requires an https connexion to use the audio inputs. On the other hand MIDI is not supported by Firefox.","title":"Recommended Browsers"},{"location":"community/news/#useful-links","text":"Editor : the official link, https://grame-cncm.github.io/fausteditorweb/ : an alternative link on GitHub. Because this is an https address, audio inputs will work (but not the export function), https://github.com/grame-cncm/fausteditorweb : the GitHub repository.","title":"Useful links"},{"location":"community/news/#2017-09-15-performances","text":"","title":"2017-09-15: Performances..."},{"location":"community/news/#performances-of-audio-dsp-code-compiled-in-webassembly","text":"Porting and running large C/C++ code base on the Web have been the subject of several competing projects in the recent years, from Google NaCl/PNaCl to Mozilla asm.js . Recently standardized WebAssembly language inherits from ideas experimented in both approaches, with the Mozilla vision finnally winning as Robert O'Callahan explains here . Coupled with the WebAudio API , running real-time audio code in the Web now appears to be an achievable goal. WebAssembly is a hot topic in the JavaScript ecosystem. The WebAudio community is eagerly waiting for the AudioWorklet specification, with its promised reduced latency and glitch-free audio rendering, to land in browser development versions, and be tested. Porting well established C/C++ codebase with Emscripten , like the Csound framework as an example, or using DSL languages like Faust, will then naturally beneficiate from improved and more stable performances. The Faust ecosystem already allows to generate static or dynamically compiled WebAssembly based WebAudio nodes . These nodes are still using the deprecated ScriptProcessor WebAudio interface. Premillinary work has been started to be ready as soon at the AudioWorklet model will be testable. In the meantime, work have been started using the WAVM , a standalone VM for WebAssembly, that can load both the standard binary and text wasm format, compiling it in native code using the LLVM chain (generating LLVM IR and compiling it on the fly to native code using LLVM JIT compiler), and running it at (near) native speed. Glue code to load and run Faust generated wasm modules has been written. Validation and benchmarking tools have been developed. Performances comparison with the C++ and LLVM IR Faust backends is the subject of this post.","title":"Performances of audio DSP code compiled in WebAssembly"},{"location":"community/news/#comparing-the-faust-c-llvm-ir-and-wastwasm-backends","text":"The WebAssembly approach promises near native performances for C/C++ written code compiled to WebAssembly using the Emscripten tool chain. Other languages like Rust (using the mir2wasm tool) experiment direct WebAssembly generation. It seems clear that as WebAssembly specification and implementation stabilize, more and more languages will directly generate wasm to be deployed in browsers. The question of the quality of code generation at each step of the compilation chain will rapidly emerge. While WebAssembly is initially designed to run on the Web, it may be deployed in non Web environnement like nodejs , or even in standalone VM like WAVM . Thus WebAssembly becomes a portable binary format that can be used in a large variety of situations. This is especially of interest for a DSL language like Faust.","title":"Comparing the Faust C++, LLVM IR and wast/wasm backends"},{"location":"community/news/#faust-wastwasm-backend","text":"Faust wast/wasm backend directly produce WebAssembly code from the Faust internal FIR (Faust Imperative Representation) code. Generated modules are rather light since they define a very simple ABI to be used by the loader code. Two generation models have been defined: in monophonic mode the wast/mast module internally allocates a memory block to be used for the DSP state (controllers, delays lines, waveforms...) as well as audio buffers. in polyphonic mode, the memory block will be allocated by the loader environnement. This block will typically be sized to contain all the needed voices for the polyphonic DSP. In both cases, a full description of the DSP state as a JSON string is generated in the module data segment (including memory indexes of all controllers). Loader code will get and decode this JSON description, and use whatever parts of the description it needs to run the DSP code. In particular, control memory zones (corresponding to the UI items like buttons, sliders, bargraph...) can be directly read/written by the wrapper code.","title":"Faust wast/wasm backend"},{"location":"community/news/#benchmark-of-c-llvm-ir-and-wastwasm-generated-code","text":"Since Faust already generates C++ or LLVM IR code, the performances of those two backends can be compared with the new wasm one. Using the WAVM C++ written machine allows to deploy the same measuring code . The first benchmark compares the speed of C++, LLVM IR and wasm backends running a set of DSP, running on a MacBook Pro 2,2 GHz Core I7 with OSX El capitan. The same 4.0 version of LLVM toolchain has been used with the three backend. C++ and LLVM IR code has been compiled with the -Ofast optimization flag, the WAVM runtime is the standard version one (without any specific audio optimization, see later): The diagrams clearly shows that the wasm code is still slower than C++ or LLVM IR code, but speed difference is not so high in most cases. Some DSP behaviours need to be understood in more details.","title":"Benchmark of C++, LLVM IR and wast/wasm generated code"},{"location":"community/news/#optimizing-the-wavm-runtime-for-audio-code","text":"The WAVM runtime strictly conforms to the WebAssembly specification, thus behaving as a interesting base reference. In the audio domain, the deployed code is usually compiled with specific optimization flags. Since C++ WAVM runtime can be hacked quite easily, we did several changes into the reference implementation to gain some speed: removing the atomic flag in all load/store that are added to pass all spec WebAssembly tests. adding the equivalent of -fast-math compilation flag that have to be done at LLVM IR and JIT (= native) generation steps. and finally simplifying some mathematical operators, using their standard definition instead of the specific WAVM coded ones that strictly implement WebAssembly official semantic (see for instance the definition of f32.min/f32.max operations). Here is the diagram of DSP examples run with reference WAVM runtime, and the three specific optimizations: After generating the LLVM IR code, the WAVM runtime runs a set of LLVM IR to IR optimizations passes. It remains to be tested if adding more optimization passes (especially the auto-vectorizations ones) could help producing even better code.","title":"Optimizing the WAVM runtime for audio code"},{"location":"community/news/#webassembly-module-optimization-with-binaryen","text":"Binaryen is a compiler and toolchain infrastructure library for WebAssembly , written in C++. We tested the wasm-opt tool at -O3 level on Faust generated wasm modules to estimate which speedup we can expect. The following diagram shows limited gains, with no more than 5% in some of the tested cases:","title":"WebAssembly module optimization with Binaryen"},{"location":"community/news/#float-denormal-handling","text":"A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Even if using software ftz is not strictly needed in our benchmark chain (since the C++ WAVM uses the ftz hardware protection mode), we can still compare the speed of the different ftz options. Here is the result of code generated with -ftz from 0 to 2:","title":"Float denormal handling"},{"location":"community/news/#comparing-three-browsers-on-osx-el-capitan","text":"HTML test pages were prepared to compare the performances of the three main browsers on OSX El Capitan. The DSP code is compiled with float denormal protection on (-ftz 2). The generated wasm module compute method is called repeatedly in a timed loop, using successive slices of a big allocated circular audio buffer to avoid cache effects. Here are the results: The fasted one (Chrome for now) can be compared with C++, LLVM IR, WAVM native engines, all compiled with float denormal protection on (-ftz 2):","title":"Comparing three browsers on OSX El Capitan"},{"location":"community/news/#comments-and-conclusion","text":"Testing wasm JIT machines inside browsers is not an easy task. The C++ WAVM runtime revealed to be an excellent tool to compare the Faust C++, LLVM IR and wasm backend. Since its code can be easily adapted, one can estimate also what can be expected deploying wasm DSP modules in pure native environments , outside of the browser, where some audio specific optimizations may be considered. Measures done on a set of Faust DSP show that WebAssembly code still run slower than C++ or LLVM IR generated code in most cases, up to almost 66% slower in the less favorable examples. This value will typically be a bit worse when deploying in browsers, since float denormal protection code has to be used . Benchmarks in browser wasm runtime still need to be done to confirm or refine these findings. Comparing the Chrome , Firefox and WebKit browsers on OSX El Capitan shows that Chrome is currently the fastest engine in most cases, with Firefox and WebKit quite similar (with a slight plus for WebKit). Comparing the Chrome browser with native engines shows results from 4,8 times slower (filterBank.dsp), 2,8 times slower (sTunedBar6.dsp) up to much more favorable cases (karplus32.dsp). Note that filterBank.dsp example is a bit of a pathological case, since Chrome is significantly slower than Firefox and WebKit in this case, and filterBank.dsp uses a lot of pow(10, x) code that is rewritten an optimized as exp10(x) with the C++ backend path.","title":"Comments and Conclusion"},{"location":"community/news/#2017-08-18-faust-on-the-web","text":"","title":"2017-08-18: Faust on the Web"},{"location":"community/news/#deploying-faust-dsp-on-the-web","text":"EDIT : we are at the Web Audio conference 2017, and it appears that the way we currently extend the ScripProcessorNode with Faust code is not the Right Way... Part of the post concerning the exposed API will probably change a bit in the near future... Using latest developments done for the Web (the new WebAssembly backends and libfaust library compiled in WebAssembly with Emscripten), statically and dynamically Faust generated WebAudio nodes can be easily produced and deployed on the Web.","title":"Deploying Faust DSP on the Web"},{"location":"community/news/#deploying-statically-compiled-faust-webaudio-nodes","text":"From a foo.dsp source file, JavaScript and the associated WebAssembly files can be produced with the following script: faust2wasm foo.dsp This will generate a foo.wasm file with the WebAssembly module as binary code, as well as a foo.js wrapper file containing the code needed to turn the Faust DSP in a fully working WebAudio node (using an extended ScriptProcessor node). The name of the Faust DSP code file is used to define the final ScriptProcessorNode constructor name. So for instance if osc.dsp file is compiled, the following faust.createosc function will be generated: /** * Create a 'monophonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createosc = function(context, buffer_size, callback) The resulting object is an extended ScriptProcessorNode, to be used as a regular node (like connected to other WebAudio nodes), but which also adds the Faust specific API as defined in the equivalent C++ generated dsp class (see the architecture/faust/dsp/dsp.h header for more technical details), as well as JavaScript more specific functions. For instance the following ones will have to be used to control the node: var paths = node.getParams(); // get the set of paths to read/write input control parameters Then knowing the path for a given parameter, the following function is used to change the parameter value: node.setParamValue(\"/Oscillator/freq\", 0.6); A full JSON description of the node with the complete UI, can be retrieved with: var json = node.getJSON(); The complete usable API is fully documented in the generated JavaScript file in the Public API to be used to control the WebAudio node section.","title":"Deploying statically compiled Faust WebAudio nodes"},{"location":"community/news/#a-simple-example-web-page","text":"A simple Web page using the files generated by faust2wasm on the noise.dsp file can be defined with the following parts: <!-- Load 'faust2wasm' script generated .js file --> <script src=\"noise.js\"></script> A slider to control the noise volume parameter is defined with: <P> Noise volume: <input type=\"range\" oninput=\"changeVolume(event) \"min=\"0\" max=\"1\" value=\"0.5\" step=\"0.01\"/> The WebAudio context is created and the noise slide hander is defined with: var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var noise = null; // Slider handler to change the 'noise' volume function changeVolume(event) { noise.setParamValue(\"/Noise/Volume\", parseFloat(event.target.value)); } A startnoise function which creates the Faust WebAudio node is defined with: function startnoise() { // Create the Faust generated node faust.createnoise(audio_context, 1024, function (node) { noise = node; console.log(noise.getJSON()); // Print paths to be used with 'setParamValue' console.log(noise.getParams()); // Connect it to output as a regular WebAudio node noise.connect(audio_context.destination); }); } An finally the load handler is defined to activate the code: window.addEventListener(\"load\", startnoise); Look at the Noise and OSC online pages for the complete code. Note that pages loading an additional .wasm file cannot directly be loaded in Chrome. You'll have to start a local server (using the python -m SimpleHTTPServer command for instance) and access them with their http:// based URL.","title":"A simple example Web page"},{"location":"community/news/#generating-polyphonic-webaudio-nodes","text":"Assuming that the compiled Faust DSP file is polyphonic ready , a polyphonic ready WebAudio node can be created with the -poly parameter, and will generate the following constructor for the node (where the mydsp part will be replaced by the actual DSP name): /** * Create a 'polyphonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * to be use for the voice, and allocating the number of needed voices * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode * as parameter, or null in case of error */ faust.createmydsp_poly = function(context, buffer_size, polyphony, callback) Polyphonic nodes have an extended API to be controled with MIDI messages: /** * Instantiates a new polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOn = function (channel, pitch, velocity) /** * De-instantiates a polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOff = function (channel, pitch, velocity) /** * Gently terminates all the active voices. */ allNotesOff = function () Look at the JavaScript public documentation section for the complete description.","title":"Generating Polyphonic WebAudio nodes"},{"location":"community/news/#extended-control-with-comb-parameter","text":"The faust2wasm tool can be used with the -comb parameter to compile several DSP files and contatenate all JavaScript code in a unique resulting comb.js file (possibly to be used in -poly mode also).","title":"Extended control with -comb parameter"},{"location":"community/news/#generating-fully-working-self-contained-html-pages","text":"The faust2webaudiowasm script can be used to generate a fully working self-contained HTML page, with a SVG/CSS a Graphical User Interface. From the osc.dsp Faust DSP source file, it will generate an osc.html file: faust2webaudiowasm osc.dsp Assuming that the compiled Faust DSP file is polyphonic ready, the -poly parameter can be used to generate a polyphonic MIDI controlable instrument, to be used with a MIDI application or device. The -links generates the DSP processor SVG representation, and links to the original DSP file as well as generated SVG files, so that the HTML page can possibly be deployed as a reusable Faust DSP resource.","title":"Generating fully working self-contained HTML pages"},{"location":"community/news/#webassembly-module-optimization","text":"Assuming that you have Binaryen tools installed on your machine, the faust2wasm and faust2webaudiowasm scripts can take an additional -opt parameter to allow WebAssembly module optimization.","title":"WebAssembly module optimization"},{"location":"community/news/#deploying-dynamically-compiled-faust-webaudio-nodes","text":"Since the libfaust library is available for the Web, it becomes possible to embed the complete dynamic compilation chain in a Web page , from the Faust DSP source to the executable WebAudio node. First the following resources (located on the Faust GitHub in architecture/webaudio folder) have to be loaded in the page: <!-- Load 'libfaust' library and wrapper code --> <script src=\"libfaust-wasm.js\"></script> <script src=\"webaudio-wasm-wrapper.js\"></script> Then the two following functions are used to generate factories, creating later on monophonic or polyphonic instances (this is necessary because of the way internal WebAssembly memory is managed): /** * Create a DSP factory from source code as a string to be used to create monophonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createDSPFactory = function (code, argv, callback) /** * Create a DSP factory from source code as a string to be used to create polyphonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createPolyDSPFactory = function (code, argv, callback) The two following functions are used to generate monophonic or polyphonic Faust WebAudio nodes: /** * Create a ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createDSPInstance = function (factory, context, buffer_size, callback) /** * Create a 'polyphonic' 'ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createPolyDSPInstance = function (factory, context, buffer_size, polyphony, callback) The resulting nodes have the same API as statically compiled nodes described in the first section, so can be controlled the same way, including the polyphonic ones. Here is a code example using faust.createDSPFactory and faust.createDSPInstance : var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var dsp_code = \"import(\\\"stdfaust.lib\\\"); vol = hslider(\\\"volume [unit:dB]\\\", 0, -96, 0, 0.1) : ba.db2linear : si.smoo; freq = hslider(\\\"freq [unit:Hz]\\\", 1000, 20, 24000, 1); process = vgroup(\\\"Oscillator\\\", os.osc(freq) * vol);\"; var osc = null; var libraries_url = \"/modules/libraries/\"; function startosc() { // Prepare argv list var argv = []; argv.push(\"-ftz\"); argv.push(\"2\"); argv.push(\"-I\"); argv.push(libraries_url); // Dynamically create the Faust generated node from explicit DSP source in 'dsp_code' faust.createDSPFactory(dsp_code, argv, function (factory) { faust.createDSPInstance(factory, audio_context, 1024 function (node) { osc = node; console.log(osc.getJSON()); // Print paths to be used with 'setParamValue' console.log(osc.getParams()); // Connect it to output as a regular WebAudio node osc.connect(audio_context.destination); })}); } The Dynamic OSC page demonstrates the dynamic OSC complete code (based on the example seen before). The Dynamic Organ page demonstrates a polyphonic organ instrument, which loads a DSP from an url, and ready to be controlled with a MIDI device or application. Look at the Dynamic Faust compiler page for a more complete use-case of the dynamic compiler.","title":"Deploying dynamically compiled Faust WebAudio nodes"},{"location":"community/news/#float-denormal-handling_1","text":"A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Use for example the following line to active software denormal handing when using faust2wasm tool: faust2wasm -ftz 2 foo.dsp The same for the faust2webaudiowasm tool: faust2webaudiowasm -ftz 2 foo.dsp For dynamic compilation, the -ftz v flag will have to be added in the argv parameter in faust.createDSPFactory or faust.createPolyDSPFactory , like for instance: faust.createPolyFactory(dsp_code, ['-ftz', '2'], callback);","title":"Float denormal handling"},{"location":"community/news/#2017-06-16-memory-allocator","text":"","title":"2017-06-16: Memory allocator"},{"location":"community/news/#using-a-custom-memory-allocator","text":"From a DSP source file, the Faust compiler typically generates a C++ class. When a rdtable item is used on the source code, the C++ class will contain a table shared by all instances of the class. By default, this table is generated as a static class array, and so allocated in the application global static memory. In some specific case (usually in more constrained deployment cases), managing where this data is allocated is crucial. By extension this post explains how a custom memory allocator can be used to precisely control the DSP memory allocation.","title":"Using a custom memory allocator"},{"location":"community/news/#faust-mem-option-to-control-memory-related-code-generation","text":"A new -mem compiler parameter has been added in the Faust compiler, starting from the 0.9.103 version (or 2.1.4 in Faust2 branch). This parameter will change the way static shared tables are generated. The table is allocated as a class static pointer allocated using a custom memory allocator , which has the following propotype: struct dsp_memory_manager { virtual ~dsp_memory_manager() {} virtual void* allocate(size_t size) = 0; virtual void destroy(void* ptr) = 0; }; Taking the following Faust DSP example: process = (waveform {10,20,30,40,50,60,70}, %(7)~+(3) : rdtable), (waveform {1.1,2.2,3.3,4.4,5.5,6.6,7.7}, %(7)~+(3) : rdtable); Here is the generated code in default mode: ... int mydsp::itbl0[7]; float mydsp::ftbl0[7]; static void classInit(int samplingFreq) { SIG0 sig0; sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; sig1.init(samplingFreq); sig1.fill(7,ftbl0); } virtual void init(int samplingFreq) { classInit(samplingFreq); instanceInit(samplingFreq); } virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are static class arrays. They are filled in the classInit method. The architecture code will typically call the init method (which calls classInit ) on a given DSP, to allocate class related arrays and the DSP itself. If several DSP are going to be allocated, calling classInit only once then the instanceInit method on each allocated DSP is the way to go. In the new -mem mode, the generated C++ code is now: ... int* mydsp::itbl0 = 0; float* mydsp::ftbl0 = 0; dsp_memory_manager* mydsp::fManager = 0; static void classInit(int samplingFreq) { SIG0 sig0; itbl0 = static_cast<int*>(fManager->allocate(sizeof(int) * 7)); sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; ftbl0 = static_cast<float*>(fManager->allocate(sizeof(float) * 7)); sig1.init(samplingFreq); sig1.fill(7,ftbl0); } static void classDestroy() { fManager->destroy(itbl0); fManager->destroy(ftbl0); } virtual void init(int samplingFreq) {} virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are generated a class static pointers. The classInit method takes the additional dsp_memory_manager object used to allocate tables. A new classDestroy method is available to deallocate the tables. Finally the init method is now empty, since the architecure file is supposed to use the classInit/classDestroy method once to allocate and deallocate static tables, and the instanceInit method on each allocated DSP.","title":"Faust -mem option to control memory related code generation"},{"location":"community/news/#control-of-the-dsp-memory-allocation","text":"An architecture file can now define its custom memory manager by subclassing the dsp_memory_manager abstract base class, and implement the two required allocate and destroy methods. Here is an example of a simple heap allocating manager: struct malloc_memory_manager : public dsp_memory_manager { virtual void* allocate(size_t size) { void* res = malloc(size); cout << \"malloc_manager: \" << size << endl; return res; } virtual void destroy(void* ptr) { cout << \"free_manager\" << endl; free(ptr); } };","title":"Control of the DSP memory allocation"},{"location":"community/news/#controlling-the-table-memory-allocation","text":"To control table memory allocation, the architecture file will have to do: // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Allocate the dsp instance using regular C++ new mydsp* dsp = new mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Deallocate the dsp instance using regular C++ delete delete dsp; // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy();","title":"Controlling the table memory allocation"},{"location":"community/news/#controlling-the-complete-dsp-memory-allocation","text":"Full control the DSP memory allocation can be done using C++ placement new : #include <new> // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Placement new using the custom allocator mydsp* dsp = new(manager.allocate(sizeof(mydsp))) mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Calling the destructor dsp->~mydsp(); // Deallocate the pointer itself using the custom memory allocator manager.destroy(dsp); // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy(); More complex custom memory allocators can be developed by refining this malloc_memory_manager example, possibly defining real-time memory allocators...etc... The OWL architecture file already uses this new custom memory allocator model. This is a work in progress: in the Faust2 branch, this model is still not supported yet beside the C++ backend custom memory allocator is not yet supported is additional DSP classes (like the mydsp_poly defined in the achitecture/faust/dsp/poly-dsp.h header).","title":"Controlling the complete DSP memory allocation"},{"location":"community/news/#2017-04-26-optimizing","text":"","title":"2017-04-26: Optimizing..."},{"location":"community/news/#optimizing-the-dsp-cpu-usage","text":"The Faust compiler has as lot of different compilation parameters to play with. Discovering them for a given DSP program is something that can be automated. Two measure_dsp and dsp_optimizer classes are available for developers to measure DSP CPU use directly in their code. Two more friendly faustbench and faustbench-llvm tools have been developed using them. They allow to discover the best Faust compiler parameters, to be used later on with faust2xx scripts, faustgen~ Max/MSP external or FaustLive .","title":"Optimizing the DSP CPU usage"},{"location":"community/news/#the-measure_dsp-and-dsp_optimizer-dsp-decorator-classes","text":"The measure_dsp class defined in the faust/dsp/dsp-bench.h file allows to decorate a given DSP object and measure its compute method CPU consumption. Results are given in Megabytes/seconds (higher is better). Here is a C++ code example of its use: static void bench(dsp* dsp, const string& name) { // Init the DSP dsp->init(48000); // Wraps it with a 'measure_dsp' decorator measure_dsp mes(dsp, 1024, 5); // Measure the CPU use mes.measure(); // Print the stats cout << name << \" CPU use : \" << mes.getStats() << endl; } Only part of the Faust2 branch and defined in the faust/dsp/dsp-optimizer.h file, the dsp_optimizer class uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. Here is a C++ code example of its use: static void dynamic_bench(const string& dsp_source) { // Init the DSP optimizer with the dsp_source to compile // (either the filename or source code string) dsp_optimizer optimizer(dsp_source, \"/usr/local/share/faust\", \"\", 1024); double value; // Discover the best set of parameters vector<string> options = optimizer.findOptimizedParameters(value); // Print the result cout << \"Best value is for '\" << argv[1] << \"' is : \" << value << \" with \"; for (int i = 0; i < options.size(); i++) { cout << options[i] << \" \"; } cout << endl; }","title":"The measure_dsp and dsp_optimizer DSP decorator classes"},{"location":"community/news/#using-the-faustbench-tool","text":"The faustbench tool uses the C++ backend to generate a set of C++ files produced with different Faust compiler options. All files are then compiled in a unique binary that will measure DSP CPU of all versions of the compiled DSP. The tool is supposed to be launched in a terminal, but it can be used to generate an iOS project, ready to be launched and tested in Xcode. Here are the available options: faustbench [-ios] [Additional Faust options (-vec -vs 8...)] <file.dsp> Use '-ios' to generate an iOS project Use 'export CXX=/path/to/compiler' before running faustbench to change the C++ compiler Use 'export CXXFLAGS=options' before running faustbench to change the C++ compiler options Here is a trace of its use: faustbench karplus32.dsp Selected compiler is g++ with CXXFLAGS = -Ofast -scal : 77.5123 -vec -lv 0 -vs 4 : 64.2194 -vec -lv 0 -vs 8 : 80.8951 -vec -lv 0 -vs 16 : 106.244 ..... -vec -lv 1 -vs 128 -g : 130.635 -vec -lv 1 -vs 256 -g : 134.335 -vec -lv 1 -vs 512 -g : 135.352 Best value is : 136.235 with -vec -lv 0 -vs 512","title":"Using the faustbench tool"},{"location":"community/news/#using-the-faustbench-llvm-tool","text":"Available in the faust2 branch only, the faustbench-llvm tool uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. In the main Faust folder, use make bench && sudo make install to build and install the tool. Here is a trace of its use: faustbench-llvm karplus32.dsp Estimate timing parameters -scal : 21.1269 duration = 0.102801 count = 24318 Discover best parameters option -scal : 21.1034 -vec -lv 0 -vs 4 : 42.0734 -vec -lv 0 -vs 8 : 55.3725 -vec -lv 0 -vs 16 : 85.3855 ..... -vec -lv 1 -vs 128 -dfs : 133.974 -vec -lv 1 -vs 256 -dfs : 139.12 -vec -lv 1 -vs 512 -dfs : 91.8424 Refined with -mcd -vec -lv 0 -vs 256 -g -mcd 2 : 83.5555 -vec -lv 0 -vs 256 -g -mcd 4 : 138.519 -vec -lv 0 -vs 256 -g -mcd 8 : 140.122 -vec -lv 0 -vs 256 -g -mcd 16 : 141.558 -vec -lv 0 -vs 256 -g -mcd 32 : 139.454 -vec -lv 0 -vs 256 -g -mcd 64 : 143.405 -vec -lv 0 -vs 256 -g -mcd 128 : 142.975 -vec -lv 0 -vs 256 -g -mcd 256 : 139.345 Best value is for 'karplus32.dsp' is : 142.473 with -vec -lv 0 -vs 256 -dfs -mcd 64 w","title":"Using the faustbench-llvm tool"},{"location":"community/news/#2017-02-21-faust-meets-juce","text":"JUCE is an open-source cross-platform C++ application framework, used for the development of desktop and mobile applications. JUCE is used in particular for its GUI and plugins libraries. A set of architecture files have been developed to deploy standalone or plugins built from Faust code. They allow to automatically generate the GUI from the Faust program, possibly supporting polyphonic instruments, and be controlled by MIDI or OSC messages. The architecture files are then combined to produce ready to compile JUCE applications or plugins, using tools that are part of the Faust distribution. They can also be accessed using the Faust online compiler.","title":"2017-02-21: Faust meets JUCE"},{"location":"community/news/#faust2juce-script","text":"faust2juce transforms a Faust DSP program into a fully working JUCE standalone application or plugin, which can possibly be controlled with MIDI or OSC messages. Read its complete description here . You'll have to get a recent github version of Faust tree to use it.","title":"faust2juce script"},{"location":"community/news/#using-the-online-compiler","text":"The Faust online compiler has been updated to provide new 'juce' targets. Note that only some of the possible compilation options are availble for now: the application target produces a standalone MIDI controlable application (using Faust polyphonic code if the Faust source code is polyphonic aware) the plug-in target produces a MIDI controlable mono or polyphonic plugin (using Faust polyphonic code if the Faust source code is polyphonic aware) the jsynth target produces a MIDI controlable mono or polyphonic plugin (using JUCE polyphonic Synthesizer if the Faust source code is polyphonic aware) Directly using faust2juce provides the full control of the generated target with access to all possible compilation parameters.","title":"Using the online compiler"},{"location":"community/news/#graph-of-faust-generated-plugins","text":"Here is an example of three Faust generated plugins running in JUCE plugin host:","title":"Graph of Faust generated plugins"},{"location":"community/news/#using-libfaust-and-llvm","text":"An alternative to faust2juce static-compilation model, is to use Oliver Larkin's juce_faustllvm module, also used in his pMix2 tool .","title":"Using libfaust and LLVM"},{"location":"community/news/#2017-01-13-webassembly","text":"","title":"2017-01-13: WebAssembly..."},{"location":"community/news/#faust-webassembly-backend","text":"WebAssembly was born with the premise of creating a safe, portable and fast to load and execute format suitable for the web. WebAssembly its not a programing language but a compilation target with a text and binary specs. That means that other low level languages like C/C++, Rust, Swift, etc. can compile to WebAssembly. Specified and developed by principal browser compagnies (Google, Mozilla, Microsoft and Apple), this new format aims to finally replace the more hackish \"asm.js\" format initialy developed by Mozilla. Development versions of Chrome and Firefox can already execute it. To get an early preview of this experimental technology, at your own risk: on Chrome Canary , open chrome://flags/#enable-webassembly and enable the switch on Firefox Nightly , open about:config and set javascript.options.wasm to true See a preview of Microsoft Edge support and follow Safari support on WebKit\u2019s feature status .","title":"Faust WebAssembly backend"},{"location":"community/news/#webassembly-backends","text":"New WebAssembly backends have been added in the faust2 development branch. They allow to generate textual or binary WebAssembly code.","title":"WebAssembly backends"},{"location":"community/news/#wast-textual-backend","text":"The 'wast' backend allows to generate textual WebAssembly code (in s-expression like format). Note that as of january 2017, the official textual format is not yet fully specified, thus we follow the format used in the binaryen tool . Use the following command to generate the textual output in the terminal for a given foo.dsp file. faust -lang wast foo.dsp The following command: faust -lang wast foo.dsp -o foo.wast will generate the foo.wast textual WebAssembly output file as well as an additional foo.js JavaScript file containing glue code.","title":"'wast' textual backend"},{"location":"community/news/#wasm-binary-backend","text":"The 'wasm' backend allows to generate binary WebAssembly code. Use the following command to generate the binary output in the terminal for a given foo.dsp file. faust -lang wasm foo.dsp The following command: faust -lang wasm foo.dsp -o foo.wasm will generate the foo.wast binary WebAssembly output file as well as an additional foo.js JavaScript file containing glue code.","title":"'wasm' binary backend"},{"location":"community/news/#generating-static-html-pages","text":"WebAssembly code can be feeded into WebAudio JavaScript nodes, which can then be used like any other native WebAudio node. Two scripts are available to generate static WebAudio html pages from a given foo.dsp source file with the generated html/css/svg user interface: faust2webaudiowast foo.dsp will generate the textual WebAssembly output, use binaryen wasm-as tool to convert the wast to wasm format (you'll have to compile and install the binaryen tools on your machine), and produce a self-contained html page. faust2webaudiowasm foo.dsp will generate the binary WebAssembly output that can directly be loaded by the produced self-contained html page. Page containing polyphonic instruments can be generated with the following commands: faust2webaudiowast -poly foo.dsp to use the 'wast' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument. faust2webaudiowasm -poly foo.dsp to use the 'wasm' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument.","title":"Generating static HTML pages"},{"location":"community/news/#2016-10-17-faust-award-2016","text":"The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale","title":"2016-10-17: Faust Award 2016"},{"location":"community/news/#faust-award-2016-to-ambitools","text":"The Faust Award 2016 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Dave Phillips (musician, journalist, and educator, USA) Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to Ambitools , a set of tools for real-time 3D sound field synthesis using higher order ambisonics (HOA). Ambitools is developed by Pierre Lecomte, a PhD candidate at Conservatoire National des Arts et M\u00e9tiers and Sherbrooke University. The core of the sound processing is written in Faust. The tools contain HOA encoders, decoders, binaural-filters, HOA signals transformations, spherical VU-Meter, etc. and can be compiled in various plug-ins format under Windows, Mac OSX, and Linux. The jury praised the quality and the usefulness of Ambitools: a really useful and technically advanced Faust app and an impressive technical achievement ! Check the demo . The committee was also very impressed by the quality of two other projects : Voice of Faust , a voice synthesizer/effects machine by Bart Brouns ( demo ). PMix , a graphical patcher, preset interpolator and JIT compiler for FAUST by Oliver Larkin ( demo ).","title":"Faust Award 2016 to Ambitools"},{"location":"community/news/#faust-student-software-competition-to-touchvoices","text":"In parallel to the main competition, we introduced this year a junior competition: the Faust Student Software Competition , intended to promote small but interesting Faust applications, typically written as student projects. The student prize was awarded to TouchVoices (by Pierre-Adrien Th\u00e9o, RIM Master student at University Jean Monnet) a real-time web application allowing to capture, playback and transform sound loops. Here is a video of Pierre-Adrien Th\u00e9o during a performance with TouchVoices . A very close competitor was SuperBeatRepeater (by Vincent Rateau, of SuperDirt fame), a sample accurate beat repeater. Don't miss the demo !","title":"Faust Student Software Competition to TouchVoices"},{"location":"community/news/#2016-08-30-faust-book","text":"","title":"2016-08-30: FAUST book..."},{"location":"community/news/#the-first-faust-book-is-korean","text":"\u201c Sound Programming using FAUST \u201d, written by Jin-Wook Chae , an experienced audio developer and sound engineer (right) and Hyun-Hoo Jung (left), is the very first book ever published on FAUST. While the book is written in Korean, I was able to really appreciate the choice of the examples and the elegance as well as the high quality of the code. I am sure it will be an invaluable tool to promote FAUST in Korea among sound engineering, computer music students and more generally any person interested in sound programming. This book is for people desiring to produce musical instruments or sound processors. I have always been instructing my students that the ultimate importance is to discover interesting ideas about the sound. In spite of that, I have often relied on an unflattering response such as \"you may need to learn a programming language like C/C++...\" when a student asked for help with how to execute his/her ideas related to sound. Now I am pleased to recommend the use of FAUST to bring such ideas into execution. This is an easy self-study guide that can help to do just that. Now I can confidently tell anybody pursuing sound or electronic music that their exciting and brilliant idea about sound is what truly counts! So, really, how do we execute our ideas? Today I am introducing you to FAUST and to this book which you will find immensely helpful in terms of how to use FAUST to bring your fabulous ideas into reality. Jinwook Chae","title":"The first FAUST book is Korean !"},{"location":"community/news/#2016-06-30-faust-interpreter","text":"A new 'interpreter' backend has been added in the faust2 development branch. It allows to execute Faust programs without using the LLVM dynamic compiler chain.","title":"2016-06-30: Faust interpreter"},{"location":"community/news/#interpreter-compilation-chain","text":"The dynamic compilation chain allows developers to embed the Faust compiler technology directly in their application or plugins. Faust2 development branch uses an intermediate FIR representation (Faust Imperative Representation), which can be translated to several output languages. An LLVM backend has been previously developed to allows applications to compile a DSP source into executable code in memory, bypassing the external compiler requirement. In some specific situations, embedding the LLVM chain is not possible : for instance Apple does not allow to deploy dynamic compilers on iOS. Thus having an interpreter backend allows to get around this problem and still make Faust code run on those platforms.","title":"Interpreter compilation chain"},{"location":"community/news/#interpreter-backend","text":"The interpreter backend translates the FIR intermediate language into instructions for a virtual machine. A pure C++ interpreter for this instruction set has been implemented.","title":"Interpreter backend"},{"location":"community/news/#running-and-performances","text":"The interpreter backend translates the FIR intermediate language into bytecode for a virtual machine. It allows to run programs about 4 to 5 slower than native speed . Moreover this interpreter can be compiled in a special 'trace' mode to automatically detect various execution errors : invalid heap access, mathematical errors or warnings (division by zero, integer overloading....) which helps us to check the compiler semantic and code generation quality.","title":"Running and performances"},{"location":"community/news/#deployment-for-developers","text":"Given a Faust source code (as a file or a string), calling the createInterpreterDSPFactoryXXX function runs the compilation chain (Faust + interpreter) and generates the \u201cprototype\u201d of the class, as a interpreter-dsp-factory pointer. class interpreter_dsp_factory : public dsp_factory { public: /* Return Factory name */ std::string getName(); /* Return Factory SHA key */ std::string getSHAKey(); /* Return Factory expanded DSP code */ std::string getDSPCode(); /* Creates a new dsp instance */ dsp* createDSPInstance(); }; Note that the library keeps an internal cache of all allocated factories so that the compilation of the same DSP code, that is same source code and same set of 'normalized' (= sorted in a canonical order) compilations options, will return the same (reference counted) factory pointer. You will have to explicitly use deleteInterpreterDSPFactory to properly decrement the reference counter when the factory is no more needed. You can get a unique SHA1 key of the created factory using its getSHAKey method. Next, the createDSPInstance function, corresponding to the new className of C++, instantiates a interpreter-dsp pointer to be used through its interface, connected to the audio chain and controller interfaces. When finished, simply use delete to destroy the dsp instance. class interpreter_dsp : public dsp { public: void metadata(Meta* m); int getNumInputs(); int getNumOutputs(); void init(int samplingRate); void instanceInit(int samplingRate); dsp* clone(); void buildUserInterface(UI* inter); int getSampleRate(); void compute(int count, FAUSTFLOAT** input, FAUSTFLOAT** output); }; Since interpreter_dsp is a subclass of the dsp base class, an object of this type can be used with all already available audio and UI classes, in essence reusing all architecture files already developed for the static C++ class compilation scheme (like OSCUI, httpdUI interfaces etc.), see Developing a new architecture file .","title":"Deployment for developers"},{"location":"community/news/#savingrestoring-the-factory","text":"After the DSP factory has been compiled, your application or plugin may want to save/restore it in order to save Faust to interpreter bytecode compilation at next use. To get the internal factory compiled code, several functions are available: writeInterpreterDSPFactoryToMachine allows to get the interpreter bytecode as a string, writeInterpreterDSPFactoryToMachineFile allows to save the interpreter bytecode in a file, To re-create a DSP factory from a previously saved code, several functions are available: readInterpreterDSPFactoryFromMachine allows to create a DSP factory from a string containing the interpreter bytecode, readInterpreterDSPFactoryFromMachineFile allows to create a DSP factory from a file containing the interpreter bytecode. The complete API is available and documented in the installed faust/dsp/interpreter-dsp.h header.","title":"Saving/restoring the factory"},{"location":"community/news/#2016-04-07-web-audio-api","text":"","title":"2016-04-07: Web Audio API"},{"location":"community/news/#faust-and-the-web-audio-api-3","text":"The Faust compiler can now directly be used in a Web page. Thanks to the Emscripten compiler, the Faust compiler itself can be compiled to asm.js JavaScript. This has been done by compiling the libfaust C++ library to the libfaust.js JavaScript library, that exports a unique entry point.","title":"Faust and the Web Audio API (3)"},{"location":"community/news/#compiling-dsp-to-javascript-asmjs","text":"The libfaust.js exported function createAsmCDSPFactoryFromString(...) allows to create a DSP factory from a given DSP program as a source string and a set of compilations parameters, uses the Faust compiler asm.js backend, and produces the complete asm.js module and additional pure JavaScript methods as a string. Then calling JavaScript 'eval' function on this string compiles it in the browser. The dynamically created asm.js module and additional pure JavaScript methods can then be used. This internal code in then wrapped with additional JavaScript code. A DSP \u201cfactory\u201d will be created from the DSP source code with the following 'synchronous' code (if using the 'libfaust.js' library): var factory = faust.createDSPFactory(code, arguments); or possibly (if using the 'libfaustworker.js' library in the 'asynchronous' model): faust.createDSPFactory(code, arguments, callback); where 'code' is the DSP source as a string, and 'arguments' is an array of parameters to be given to the Faust compiler (like '-vec', '-vs 512'...), and 'callback' is a function taking the created 'factory' as argument. When no more used, you'll have to explicitly use the following code the deallocate the factory: faust.deleteDSPFactory(factory); Your application may want to save the already compiled factory as asm.js/JavaScript code to speed-up possible restore at later time: var machine_code = faust.writeDSPFactoryToMachine(factory); And restore the factory with the following code: var factory = faust.readDSPFactoryFromMachine(machine_code);","title":"Compiling DSP to JavaScript (asm.js)"},{"location":"community/news/#using-dsp-instances","text":"A fully working DSP \u201cinstance\u201d as a Web Audio node is then created with the code: var dsp = faust.createDSPInstance(factory, audio_context, buffer_size); When no more used, you'll have to explicitly use the following code to deallocate the instance: faust.deleteDSPInstance(dsp); This instance can be used like the statically compiled one, as previously described in this page .","title":"Using DSP instances"},{"location":"community/news/#polyphonic-instruments","text":"Polyphonic instruments can be produced. For a given 'factory' the following code will create a 16 voices polyphonic instance: var dsp = faust.createPolyDSPInstance(factory, audio_context, buffer_size, 16); This instance can be used like the statically compiled one, as previously described in this page .","title":"Polyphonic instruments"},{"location":"community/news/#using-faust-javascript-library","text":"The Emscripten compiled Faust library can be used in two ways. Either using the 'libfaust.js' library: <script src=\"libfaust.js\"></script> <script src=\"webaudio-asm-wrapper.js\"></script> or if using worker mode with the following code which loads the 'libfaustworker.js' library: <script src=\"webaudio/webaudio-asm-worker-wrapper.js\"></script>","title":"Using Faust JavaScript library"},{"location":"community/news/#2016-02-05-faust-award-2016","text":"","title":"2016-02-05: Faust Award 2016"},{"location":"community/news/#faust-award-2016-deadline-june-1-2016","text":"The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools build around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 15, 2016. To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc.","title":"Faust Award 2016: deadline June 1, 2016"},{"location":"community/news/#junior-competition_1","text":"In parallel to the Faust Open-Source Software Competition we introduce this year a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count.","title":"Junior Competition"},{"location":"community/news/#important-dates_2","text":"Start of the competition: February 8, 2016 Software Submission Deadline: June 1, 2016 Results of the competition: July 1, 2016","title":"Important dates"},{"location":"community/news/#submission-guidelines_1","text":"Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition.","title":"Submission Guidelines"},{"location":"community/news/#international-committee_1","text":"Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Dave Phillips (Musician/Journalist, Findlay, USA) Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA)","title":"International Committee"},{"location":"community/news/#previous-winners_1","text":"2015: Guitarix , by Hermann Meyer and Andreas Degert","title":"Previous Winners"},{"location":"community/powered-by-faust/","text":"Powered By Faust This page lists the projects using Faust in different ways: musical pieces or artistic projects, plugins or standalone applications, integration in audio programming environments, development tools, commercial applications, research projects (possibly non musical), embedded devices, Web applications, etc. polyBLEP HOLE A Faust collection of externals for Pure Data stuck together on the Organelle . The polyBLEPs are the work of Jacek Wieczorek. v1.1 triples the oscillators as sounded a bit thin. The greyhold reverb is immense. OneTrick KEYS A physically modeled piano synth with a chill lo-fi sound. It uses a vintage algorithm developed at Stanford in 1995 called \"Commuted Piano Synthesis\", and runs that through studio reverb, vinyl or tape noise, flutter, bitcrushing, and saturation. The project is using Rust and the Faust to Rust backend, and the source code is available . MOD Audio The compact and powerful standalone guitar effects ecosystem to express your creativity at home, in the studio and on stage, which can be programmed with Faust . nih-faust-jit A plugin to load Faust dsp files and JIT-compile them with LLVM. A simple GUI is provided to select which script to load and where to look for the Faust libraries that this script may import. The selected DSP script is saved as part of the plugin state and therefore is saved with your DAW project. ambient.garden ambient.garden is a musical landscape in a website, developed using Teasynth with these Faust codes . All the music in ambient.garden is generated from code. The music is then laid out in a landscape which can be explored, either interactively, or automatically when the autopilot is left on. Teasynth Teasynth is a tool to make music with code in Javascript, Faust and Sporth . There are two main ways of using it: The web editor runs in the browser and provides an instant composition environment. The command line interface can render music to audio files, serve the editor locally, and bundle music code. LICH Technology OWL platform that allows you to use Pure Data, Max Gen or Faust code into your module!. Lich is a Befaco Rebel collaboration that brings back Owl\u2019s platform with this new hardware iteration. It has stereo in and out, four pot controls summed to cv inputs (like the classic Owl module) And as addition, CV and Gate outputs, patch selection with display and USB MIDI host and device connections. lamb A lookahead compressor/limiter that's soft as a lamb, written in Faust and Rust. Lamb was made with these goals in mind: Be as clean as possible Give the user full control over the character with the minimum amount of knobs. FaustSynth Welcome to FaustSynth, a AU/VST monophonic synthesizer built with the Faust programming language. This is the project deliverable for PAT 481: Independent Study in Fall 2023. EnvelopForLive The nonprofit mission of Envelop is to connect and inspire community through immersive listening. Our listening spaces envelop the audience in pristine 3D sound, amplifying the power of music and nurturing our ability to listen together. Some Max/MSP externals are written in Faust . RCVerb (\"ReaClassical Verb\") A reverb suitable for classical music based on zita-rev1. Available as LV2 and CLAP by default (with optional VST3, VST2 and LADSPA). This plugin is part of the ReaClassical project along with RCComp (\"ReaClassical Compressor\") and Enover (RCVerb's big sister) additionals plugins, also written in Faust. Wam-Studio Wam-Studio\u2019s is an online tool for creating audio projects that you can imagine as multi-track music. Each track corresponds to a different \"layer\" of audio content that can be recorded, edited, or just integrated (using audio files for example). Some track can be used to control virtual instruments: in that case we record the sound that is generated internally by these virtual instruments (and played using a MIDI piano keyboard, for example). Tracks can be added or removed, played isolated or with other tracks. They can also be \"armed\" for recording, and when the recording starts, all other tracks will play along, while the armed track will record new content. Wam-Studio can host WAM plugins and in particular Faust ones , which can be built following this tutorial . SNES Echo Simulator SNES Echo is an cross-platform audio processing plugin, written in Faust. It simulates the SNES SPC700 DSP reverb/echo effect. This plugin does not strive for bit-accuracy and overflow handling, but instead being audibly indistinguishable for \"normal\" SPCs. Syfala project Automatic compilation of Faust audio DSP programs for AMD-Xilinx FPGAs, developed by the Emeraude team , and funded by the FAST ANR project. Supported board models are: Digilent Zybo Z7-10 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Zybo Z7-20 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Genesys ZU-3EG - Zynq UltraScale+ MPSoC Development Board Interactive Granular Texture Synthesiser An interactive granular texture synthesiser built in TouchDesigner, utilising real time signal processing of the domain-specific language Faust (functional audiostream), and the corresponding TD_Faust operator. Reflex-in Reflex-in is a sound installation that uses brain-wave streams to create music composition within the Web environment in real time. The work incorporates various state-of-the-art Web technologies, including Web Audio, WebSocket, WebAssembly, and WebGL. The music generated from the algorithm - mapping brain wave signal to musical events - aims to produce a form of furniture music that is relaxing and meditative, possibly therapeutic. The synthesizer part is created from Faust DSP and the installation can be tested here . FaustCGP Generate new audio synthesizers and filters in FAUST with Recurrent Cartesian Genetic Programming. Given a target sound or impulse response as input, the RCGP will return a FAUST synthesizer or filter, respectively, that best approximates the given signal or impulse response. Samples for an early version of the software can be found here . OneTrick URCHIN A hybrid drum synth that models the gritty lo-fi sound of beats from vintage records without sampling. It takes spectral and physically modeled drums, running them through simulated studio reverb, a vinyl or tape player, and finally a digital sampler. The result is a fat and saturated drum machine that creates a vibe of sampling with the control of a synthesizer. The project is using Rust and the Faust to Rust backend, and the source code is available . KBVerb A Faust reverb, based on the Midiverb architecture by Keith Barr . pasfa - Paste Faust code! A paste service for Faust code, to be tested here . FAUSTmapper FAUSTmapper is a tool for binding popular Digital Musical Intrument (DMI) mapping tools to the FAUST ecosystem. The default action for the FAUSTmapper project is establishing a binding to the libmapper project. When the script is run, the entire parameter space of an active FAUST project (with HTTP control enabled) will be discovered. Once discovered, a libmapper signal will be created for each of the parameters identified, including appropriate meta data such as min, max & default values. The following poster was presented at the 4th Annual International Symposium on the Internet of Sounds and was awarded the Best Poster Award. phausto Pharo is a pure object-oriented programming language and a powerful environment, focused on simplicity and immediate feedback (think IDE and OS rolled into one). Phausto allows to use Faust inside Pharo. Cantor Digitalis The Cantor Digitalis is a singing voice synthesiser controlled in real time by chironomy, i.e. by manual gesture, using interfaces such as a stylus or the fingers on a graphics tablet. More generally, it can be controlled using any MIDI interface. The synthesiser has been reimplemented in Faust by Gr\u00e9goire Locqueville during his PhD thesis . Karya Karya is a score language editor with support for scales, instrumental techniques, and ornaments, with special support for Balinese, Javanese, and Carnatic music. It has backends for MIDI, supercollider OSC, lilypond, and an incremental audio renderer that uses Faust or samples. You can write instruments in Faust and integrate them into a score along with samples and MIDI instruments. Due to incremental rendering, even computationally expensive instruments are not a problem. Body Brain Digital Musical Instrument (BBDMI) BBDMI project aims at making music from electrical signals of the muscle and the brain using EMG and EEG technologies. Producing instrumental prototypes in an open way (open software and open hardware) and to document them in the framework of open science (FAIR). The modular system is built with Max/MSP and interfaced with Faust for the purpose of analyzing, processing and mapping electrophysiological signals to sound. The paper An Interactive Modular System for Electrophysiological DMIs received a best paper award at Audio mostly 2023 . The Spatbox The Spatbox is an interface to intuitively generate 3D trajectories and to spatialize them in real-time on a loudspeaker array with Ambisonics, developed by Pierre Lecomte . Each trajectory is described by a parametric curve, where each of the coordinates varies according to a configurable LFO. Depending on the LFO parameters, many trajectories can be generated. The implementation is done in Faust and the project has been presented at PAW 2022 . MUSS3640 Vocal Synthesiser The MUSS3640 Vocal Synthesiser is a standalone application/VST3 plugin developed to allow exploratory synthesis of the singing voice. It implements a combination of formant-wave-function and bandpass synthesis techniques. The DSP is written in Faust. RITI: Room Is The Instrument RITI: Room Is The Instrument by Luca Spanedda , is a piece based on a complex system capable of manifesting emergent and chaotic behaviors, where the acoustic personality of an environment (digital or physical) becomes a case of study for the performance and is reflected in terms of variation in the behavior of the system itself. The DSP code is written in Faust. See a video of a \"studio\" performance of the system . EQUIS EQUIS is a 4 Channel DJ Mixer built on top of JACK. It's EQ is inspired by the Playdifferently Model1 and offers per channel a highpass, lowpass and sculpt eq. The code is developed in Rust and the DSP is written in Faust . See the video presentation at Sonoj convention . ESP32 Wrover E/IE audio dev board A board to play with FAUST sound synthesis language. Kuroscillators Max/MSP objects for audio and rhythmic synthesis using coupled oscillator networks. Coupled Oscillators networks are dynamical systems that describe how ensembles of interacting elements are able to self-organize and synchronize over time. In terms of sensory perception, they have been examined in a wide range of fields including those related to rhythmic entrainment, biomusicology, psychoacoustics, signal processing, and generative music. The DSP is written in Faust . Jou\u00e9 Music Instruments A new way to make music: the Jou\u00e9 Play is a system that combines an expressive multi-instrument, an intuitive app & interactive content, with a range of musical instruments that use touch-sensitive technology to create a unique playing experience. These instruments are designed to be highly expressive, allowing musicians to play with greater nuance and emotion. Part of the audio effects are coded in Faust. ExternalChugins Chugins , short for \"ChucK plugins,\" are plugins for the ChucK programming language . ChucK is an audio programming language that allows for real-time synthesis, composition, and performance of music. Chugins extend the functionality of ChucK by providing additional classes, objects, and modules that can be used to create more complex and intricate music and sound designs. ExternalChugins are a set of chugins exported from Faust. mesh2audio Generate axisymmetric 3D models, or import existing 3D models, and transform them into real-time playable physical audio models! Supports fast DSP generation of physical audio models that sound decently realistic, as well as blazing fast 2D axisymmetric model generation, at the expense of some fidelity. It is an improvement of the mesh2faust tool. The generated audio model can be played in real-time by \"striking\" (clicking) on mesh vertices in the 3D mesh viewer. OneTrick CRYPTID Whispers of a dreaded drum machine with the cold clanging heart of a DX7 in the fearsome frame of a TR-808 echo in dusty backrooms of backstreet recording studios. A contraption conjured under cover of darkness in the heinous pursuit of chart topping tracks, known only as the DX-808. It's time to bring the beast out of the shadows! Allow us to present the world's most accurate recreation of an FM drum synth skeptics say never actually existed. Using a DX7 emulator of our own design, we forged each facet of the CRYPTID, reconstructing its wretched inner-workings. From the \"Log Drum\" Toms to the \"Wood Block\" Cowbell. Blow that Samba Whistle and hit the Gong! Do you want to believe? The project is using Rust and the Faust to Rust backend, and the source code is available . Bespoke Anywhere This paper reports on the Audio Anywhere project, a framework for working with audio plugins that are compiled once and run anywhere. At the heart of Audio Anywhere is an audio engine whose Digital Signal Processing components are written in Faust and deployed with WebAssembly, by Benedict Gaster and Ryan Challinor, presented at Nime 2021 . A Technical Framework for Musical Biofeedback in Stroke Rehabilitation We here present work a generalized low-level technical framework aimed to provide musical biofeedback in post-stroke balance and gait rehabilitation, built by an iterative user-centered process. The framework comprises wireless wearable inertial sensors and a software interface developed using inexpensive and open-source tools. The interface enables layered and adjustable music synthesis, real-time control over biofeedback parameters in several training modes, and extensive supplementary functionality. JUCE and FAUST are used to create a versatile architecture for layered, yet computationally efficient real-time music synthesis. ForceHost ForceHost: an open-source toolchain for generating firmware embedding the authoring and rendering of audio and force-feedback haptics, by Christian Frisson, Mathias Kirkegaard, Thomas Pietrzak, and Marcelo M. Wanderley presented at Nime 2022 . The Faust compiler has been modified to support haptics. Sentinelle Sentinelle is a sound and robotic art installation made by J\u00e9r\u00f4me Abel . A robot-probe is placed in a dark place, a cellar. It scans its surroundings with two lasers. The reliefs of the old walls, their imperfections, mold, appear thanks to the perfectly straight lines of the lasers. Its movements are synchronized with a sound program. From these very simple visual and sound choreographies are born an imaginary on its functioning and the origin of its presence. The spectator observes in a mirror a robot which observes and testifies. Does it communicate with other systems? Does it send information? Its energy is precious, like a heartbeat or a breath, it works in a segmented way with periods of silence. Likewise, his movements are slow and relentless. Faust objects from https://github.com/grame-cncm/faust/tree/master-dev/examples included with pd-faustgen : examples/gameaudio/bubble examples/delayEcho/echo examples/gameaudio/rain examples/generator/sawtoothLab lang.faust~ and ui.faust~ CEAMMC PureData distribution 2023.02. General purpose Pd distribution and library used for work and education purposes in Centre of electroacoustic music of Moscow Conservatory ( CEAMMC ) and ZIL-electro studio. This repository is an assembly of Puredata that includes the CEAMMC library. It includes the lang.faust~ and ui.faust~ externals and a lot of Faust DSP . arco4 - sound synthesis engine and framework Arco is a sound synthesis engine that offers dynamic patching of of unit generators. It is designed to operate as a small embedded server, running either in its own process or within an application. In the spirit of \"smaller is better,\" Arco DSP is mainly delegated to FAUST , leveraging a wide range of existing algorithms. Arco control is delegated to external languages connecting through O2, which supports running Arco within the same application, in a separate process or even on a remote networked host. Arco should be a nice alternative to libpd as an embedded sound engine. The author is mainly using Arco in tandem with Serpent, a real-time Python-like scripting language, but other language bindings are possible. Synthesizer-synthesizer This is a dual-course project for CS378 NLP and CS393P. The goal is to use language model guided program synthesis to synthesize Faust DSP code to ... automatically program synthesizers. Not guaranteed to work. In the slightest. Ambisonics in KMH studios and Lilla salen The general idea behind using ambisonics for diffusing sounds in a space is to, in the first stage, encode an audio signal to a representation of a sound field - a B-format signal. This B-format signal is independent of whatever speaker array the signal will later be diffused on. In the second stage the B-format signal is decoded to the layout of a particular speaker array. In between these two stages a number of transformations may be applied, but the sound source specification may conveniently be specified in the encoder. The decoders are written in Faust. Sardine Sardine is a free/open-source software for Python 3.10+. It turns Python into a musical instrument. You can play it alone or with your friends. With Sardine you can: Play synthesizers and audio samples using SuperCollider. Control synthesizers through MIDI/OSC messages. Interconnect audio/video softwares and/or sound engines. Play collaboratively with your friends. Extend your musical environment using any Python package. Faust written DSP can be used in Sardine. KandiskyScore KandiskyScore is a graphical editor for the analysis and creation of electroacoustic/acousmatic music. It is an html/javascript application. It works perfectly with Firefox, Chrome and Opera and therefore on all Windows, OSX, Linux and other PCs. It uses the WebAudio API for sound generation and the Faust language of the GRAME for plugins. It also allows you to export a graphic score in SVG format that you can eventually modify with a vector graphics software like Inkscape or LibreOffice-draw. fildesoi1_2_3 Software (including Faust code , Max and PureData patches) to perform Fil de Soi 1 and Fil de Soi 2, mixed music pieces by Alain Bonardi for acoustic guitar and electronics. enecho Faust code for En Echo piece by Manoury for soprano and live electronics. Zen Flute The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board . souffle An electro track made with Faust . You can listen to a recording here . GHG (Gruppenhorchger\u00e4t) The project is a demonstration of a technique called delay-sum beamforming with the aim to replicate the sound heard by operators of passive sonar devices used in the second world war. Listen to the video here . The simulation code is written in Faust. Satuverb Satuverb is a flexible reverb that has many creative and natural sounding uses, produced by request for FBPM. It has a saturator and EQ controls inside the reverberator, which apply every time the signal is fed back. This causes the effects to grow more extreme as the reverb tail trails off. Satuverb's reverberator is based on Jon Dattorro's 1997 design and written in Faust . faustilogue Convert Faust DSP files to KORG logue custom oscillators, using the logue SDK . Blippoo for Wingie Blippoo for Wingie is an alternative firmware for Wingie2. The new firmware is inspired by Blippoo Box, a genius instrument created by Rob Hordijk (1958-2022), who contributed a lot to synthesizer design. May his spirit lives on in his instrument designs, thoughts, and influences. The new firmware could turn your Wingie2 into a self-contained instrument capable of producing a variety of sounds and patterns. As a great companion, it will help you in your music-making practice especially when you want to applicate controlled chaos in your music. The DSP is written in Faust . 6171_reverb A vintage reverb based on designs from 1961 and 1971, written in Faust . teensy-wfs Distributed Wave Field Synthesis (WFS) implementation for networked Teensies. There is a WFS Controller JUCE app in wfs-controller. This uses JACK's C API to set up ports and connect to any Teensy JackTrip clients. It notifies the clients of their positions in the WFS array, plus the positions of virtual sound sources, via OSC over UDP multicast. The WFS algorithm is written in Faust . pd-remote This is a simplified and unified version of the Pd remote control helpers that I've been distributing with various Pd externals such as pd-faust and pd-lua over the years. The present implementation will work with any of these and replaces the more specialized versions. It takes the form of a Pd abstraction pd-remote.pd and an accompanying pd-remote.el elisp file for Emacs. Crossroad2Effects Crossroad2Effects, the functional successor to @jatinchowdhury's CrossroadsEffects , is a genetic algorithm infrastructure for filter exploration. Provided with dry and wet sound file, Crossroad2Effect determines the filter that tampered the dry file and presents it as a Faust program. This allows users to have granular access to analog or VST filters through a programming interface. This project constructs its genetic algorithm search on top of pedalboard, Spotify's new plugin API. flatten What is an envelope flattener ? It's similar to an automatic gain control, compressor, or maximizer in that it acts by modifying the gain of the signal according to a control signal. Like these, the control signal is derived from the envelope of the input signal. The DSP is written in Faust . drumvoice Drumvoice is a percussion instrument LV2 plugin. Drumvoice can also make lots of other percussion sounds, like kick drums, toms, single hand claps, and all kinds of smaps and blinks. The DSP is written in Faust . Verber Verber is a simple audio plugin tool with a Sweet, Lushy reverb processor. It is a portolio project built in JUCE and HISE, with the DSP in Faust . REACH Extraterrestrial Reverb for Electronic Music. REACH is modern creative Reverb that is made for synthetic sound sources. There are four effects included to transform the Signal. It features modular routing, pre and post filters and over 40 Presets. Part of the DSP code is written in Faust . Stray_virtual-synth A typical wavetable synthesizer will have a table of predetermined amplitude values which are read through at the appropriate speed relative to the frequency of the current note, resulting in an audible signal. Stray functions similarly, reading through a table of values, but the amplitude values are not predefined. Instead, these values are modulated with one of four LFO shapes. The DSP code is written in Faust. Drty Drums A 4 voices drum machine based on FM synthesis [WIP]. The sound engine is made in Faust . 201 Musical Synthesizer We\u2019re Critter & Guitari and we\u2019re happy to announce our newest synthesizer: the 201! If you\u2019re familiar with our other musical instruments such as the Pocket Piano, Organelle, Bolsa Bass, or Kaleidoloop, we hope you\u2019ll see that the 201 fits right in with them: the 201 is fun, portable, and packed with a medley of musical magic! Inside, the 201 uses a combination of Pure Data and Faust musical programming environments. Users are invited to modify or create new sound engines! OneTrick SIMIAN Crash into the 80s with an open source drum synth inspired by hexagonal classics like the Simmons SDS-V . Thumping kicks , punchy snares , and sizzling cymbals coalesce with its clacky claves and crunchy claps . Bring saccharine synthwave sauce to your sublime soundscapes or drop indelable pewww pewww tom toms into your new nu-disco . Get the source code containing Faust DSP , using the Dlang backend. CollisionDrive.lv2 CollisionDrive is modeled after the Horizon Devices Precision Drive, a modern overdrive pedal with a built-in noise gate, with DSP written in Faust . MetalTone.lv2 Distortion Pedal simulation. MetalTone is modeled after the renowned BOSS MT-2 Metal Zone, a high gain distortion pedal with an advanced EQ section, with DSP written in Faust . tamgamp.lv2 Tamgamp (Rhymes with: \"Damage Amp\") is a LV2 guitar amp simulator that provides two plugins, with DSP code developed with Faust : Tamgamp - a plugin based on Guitarix DK Builder simulated chains. TamgampGX - a plugin based on tuned Guitarix internal amplifiers implementation. ReverbZen A Reverb written with Faust and JUCE, based on SchroederReverberators . This reverb effect uses different stages. It splits input signal in parallel and uses different types of delaylines. Different filters are provided to get rid of unwanted resonances. Check out reverb.dsp file to get more detailed insight. Wingie2 Wingie2 is a handheld stereo resonator that you can use as a development platform, and can be programmed with Faust . Slowmo.lv2 A multiband slow gate with delay/echo. The C++ files for the effect are generated from Faust DSP files: Bandsplit.cc , Delay.cc and Volume.cc . Vocoder App Vocoder mobile app for Android made with Faust and its Smartkeyboard interface. This app was developed in the context of a project for the the Real Time Interaction and Performance exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2020). The paper A Faust-built Mobile Vocoder Instrument, included in the repo, provides more information on the algorithm, as well as the description of a case prototype. Echoplex Ep-3 Simulator This archive contains a virtual model of the Echoplex Ep-3 tape delay. The effect has been developed using Faust in the context of a project for the Sound Processing exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2019). The paper Faust Model of the Echoplex Tape Delay, included in the repo, provides more information on the algorithm. faust2smartphone faust2smartphone is a tool to generate interactive musical mobile application embedded Faust API. DPF-Fadeli An experiment with Faust Demo Library content as DPF plugins. Basically glueing a few different projects together, to compile Faust DSP programs in several plugins format: LADSPA, LV2, VST2, VST3, CLAP : DPF faust faustpp faust examples TR8CK TR8CK is an experimental DAW/tracker with Faust live coding via faust2webaudio and UI powered by SolidJS . GuitarD It's a basic multi effects processor which follows a node based approach. Components are developed with Faust . HISE HISE is an open source framework for building sample based virtual instruments combining a highly performant Disk-Streaming Engine, a flexible DSP-Audio Module system and a handy Interface Designer. The implementation of the Faust integration was the result of a Google Summer of Code project done by Roman Sommer with the help of Christoph Hart as mentor. MBStereophony This is a simple implementation of a Regalia-Mitra filter bank using 3rd order Cauer low-pass filters as the base designs. There are four filter bank programs available which are described below. MBStereophony itself is a demo effect that down-mixes a stereo signal separately per frequency band. Audiolab A docker based DSP learning/Experimentation environment including: Jupyter lab FAUST python 3.7 (at the moment. Depends on miniconda3 docker image) FAUSTpy to run FAUST code inside jupyter faustWidgets (to interactively control FAUST code ) librosa (for MIR and feature extraction) scipy, pandas, numpy for general data science sox (encoding, batch processing etc) ffmpeg (encoding batch processing etc) seaborn (more beautiful plots) latex TODO (for exporting jupyter notebooks) LR_Delay A stereo delay plugin which emphasizes free (non beat-synced) controls for the individual channels. Built with Faust and JUCE. Leslie speaker simulator This archive presents a virtual simulation of the Leslie Speaker commonly found in Hammond electric organs. The digital effect has been developed using the FAUST programming language, and then ported into a VST-compatible format using the JUCE C++ framework. cookiecutter-dpf-faust A cookiecutter project template for DISTRHO Plugin Framework ( DPF ) audio effect plugins using FAUST for the implementation of the DSP pipeline. Look at the demo video . DF Zita Rev1 A feedback-delay-network reverb plugin built with DPF and based on a FAUST library demo. Several other projects are developed using the same DPF/FAUST methothodolgy: FAUST filters , a collection of virtual-analog filters from the FAUST standard library packaged as multi-format plugins via the DPF SendMixer , a stereo channel strip plugin with one master gain and two pre/post-fader sends Stereo Cross Delay , a stereo delay plugin with feedback and cross-mixing. Theremotion Theremotion is a virtual instrument inspired by the Theremin. Just like a Theremin, the position of your hand in the air controls the pitch and volume of the sound. However, you can also control much more dimensions of the sound with specific motions. With specific hand positions, you can control a low pass filter, a supersaw sound, a guitar sound and more. You can even make the instrument \"stick\" to a scale, making it much easier to control than a Theremin. The hand tracking is provided by Ultraleap's Leap Motion Controller . The sound generation is created with Grame's Faust . The program is built with Rust . Hypercurve Hypercurve is a library allowing you to combine several curve algorithms into a single 2D envelope. It is designed to be used in audio applications, for people who know how to enjoy a finely shaped curve. As shown above, you can perfectly combine gaussian curve with diocles cissoid curve, and plenty of other curve algorithms. The library can be used in C++, Lua, Csound and Faust . faust-mcp This package provides a Pd abstraction mcp.pd (along with some helper abstractions and externals) which lets you control your Faust instruments and effects more conveniently with control surfaces utilizing the Mackie Control Protocol (MCP). Faust.quark This SuperCollider package makes it possible to create SuperCollider packages (Quarks) containing plugins written in Faust code. With this, you can distribute plugins written in Faust and make it easy for others to install, compile or uninstall them. It also contains some simple interfaces for the faust and faust2sc.py commands used behind the scenes. Komet Komet is a computer music / sound system by Mads Kjeldgaard written in SuperCollider and Faust . Komet is a computer music system that makes advanced synthesis operations and composition easier. It auto generates thousands of synthesizer variations from simple recipes and offers a range of DAW-like features such as effect chains (like on channel strips) and other conveniences. It can work natively in stereo, multichannel or high order ambisonics mode with the flick of a switch, allowing the same compositions to be used in different sound systems. Faug A Minimoog Model D emulation with the DSP portion written in Faust and using JUCE framework. Moog + Faust = Faug. Striso Studio A virtual Web version of the Striso board, using the Faust WebAssembly compiled sythesizer code . Sttera A Software for Audio Recognition and Orchestration as Medium for Music Ritual. Faust WebAssembly library is used internally with the faust2webaudio project. XUiDesigner A WYSIWYG LV2 X11UI GUI creator tool. Provide a easy to use GUI generator tool to create X11 UI's for LV2 plugins. Currently only libxputty is supported, but the generated GUI C file could be used probably with other widget tool-kits as well, just a wrapper file is needed to translate the generated file to the needs of a toolkit. XUiDesigner could now parse faust (.dsp) files and generate a full LV2 Bundle for them. A faust (.dsp) file could be given by the command-line parameter -f or simply by drag it on the Designer window. It will create all control widgets which you could then rework to your needs before you save your Bundle. DSP Speech Processor A Faust based DSP Speech Processor. Based on the Daz DSP v2.1 Speech Processor firmware, with improvements. Compiled into Webassembly format. Runs in a web browser! Squaring Loop Synchronous AM ISB Demodulator This demodulator uses a squaring loop to regenerate the AM carrier from the sidebands during signal fades. This allows it to maintain carrier lock even without a carrier! The squaring loop multiplies the signal with itself, causing a 2F carrier to be generated. Carrier + carrier = 2F. LSB + USB = 2F. eurorack-blocks The eurorack-blocks project allows to develop your own custom Eurorack module for either prototyping or fun in the comfort of your day-to-day IDE with the C++ or Faust language , or using the Cycling '74 Max environment, testing and debugging in a virtual Eurorack environment, and when ready, to auto-magically generate all the needed files to manufacture the eurorack module for you to use in a real Eurorack modular system. AmStramGrame An arts and sciences educational project (STEAM), bringing together services and resources for the educational community. It aims at making abstract scientific concepts more tangible and concrete through musical creation and computer programming. The Gramophone is an audio device/musical instrument specifically designed for the AmStramGrame project. Its various sensors and controllers (e.g., accelerometer, gyroscope, light sensor, etc.) make it react to the user's gestures. Its rechargeable battery offering approximately five hours of autonomy and its powerful speaker make it independent from any computer, bringing it closer to traditional acoustic musical instruments. DSP programs are coded in Faust . Additional examples can be found in GramoCollection . GameLAN GameLAN is a set of musical applications designed by Grame , National Center of Musical Creation. They are based on Faust technology and have been designed to be played using only the movements of the smartphone. No musical prerequisite, only your gestures will make you a musician! Screamer Version 1.0 is the accurate Faust reproduction of a VST plug-in written in 2003. In later versions, the parameter ranges is modified and some new functionality are added. This signal mangler features a weird kind of overdrive (see source code for exact formula), a hard-clip distortion, LFO-modulated bit reduction and the possibility of calculating the modulo of a signal. Typebeat Typebeat is a virtual groovebox that\u2019s entirely keyboard-operated. Typebeat draws inspiration from two computing environments. Effects are developped in Faust then generated as Rust modules . AFDN-reverb (High-Order) Ambisonics Feedback Delay Network Reverb. Code is developed in Faust and Max. Karpsichord A virtual harpsichord based on Karplus-Strong string synthesis, implemented in Faust and running in the Web . Arduino Audio Tools Some basic header-only C++ classes that can be used for Audio Processing provided as Arduino Library. A simple Interface class to use Faust with Arduino Audio Tools is provided . Code can be written using Faust . Organelle The Organelle makes it easy to explore new sounds and experiment with new ways of making music. It combines playful and intuitive controls with a powerful and flexible sound engine. The result is an instrument that is limitless in musical possibility and a joy to play. At the heart of the Organelle's sound engine is a robust computer that runs patches. A patch allows the instrument to take on different forms. Onboard hardware for sound input and output and mappable knobs, keys and buttons enable patches to synthesize, sample, effect, and anything in between! The Organelle can be programed with Faust as explained here and with this PD external using Faust . Zrythm Zrythm is a digital audio workstation designed to be featureful and easy to use. It offers streamlined editing workflows with flexible tools, limitless automation capabilities, powerful mixing features, chord assistance and support for various plugin and file formats. A set of Faust effects are compiled as LV2 plugins and included in the application. Patches for the OWL Pedal/Eurorack Module This is a collection of patches written or ported specifically for the OWL. Most of them were written using FAUST and if you want to modify them you'll need to have a working FAUST installation. C++ source code (the .hpp files) for the OWL can be generated by running the \"updateFaustPatches.py\" python script. Then you will need to rebuild the OWL firmware and upload it to the device. Kiwi Kiwi is a graphical programming environment dedicated to music and sound creation, such as Max or Pure Data softwares, but offering a real-time collaborative approach: Kiwi allows several distant users to work simultaneously on the same patch hosted online. Kiwi is part of the French ANR-funded MUSICOLL project that unites the CICM and OhmForce. The main goal of this project is to study how collaboration can enhance the way digital audio music composition is taught and more generally how it can renew music creation practices and improve its workflow. Faust DSP programs can be dynamically compiled as objects included in the patch. An extended presentation of the system can be found in this IFC 2020 paper . Brainwave Virtual Instrument The Brainwave Virtual Instrument (BVI) is an open-source software synthesizer built in the programming language Faust. Its purpose is to facilitate the exploration of electroencephalogram (EEG) and other brain data through sonification. Pre-recorded data is translated as parameter controls of the instrument in the form of Open Source Control (OSC) messages that are generated and streamed by a small python program. The instrument can easily be distributed and compiled to different targets thanks to Faust\u2019s flexibility. Frequency Modulation synthesis provides a comprehensive approach to textural parameters of sounds, so that musical composition and improvisation based on a creative use of brain data become feasible. This is exemplified by the Brainwave Etudes (BE), a series of compositions inspired by measurements of brain activity during different states of mind. The BVI was created for two major purposes: on the one hand, to find musical structures that relate to each other in order to present an aesthetic proposal, and on the other, to create a tool that familiarizes scientists and researchers in the field of neuroscience with sonification techniques, and the exploration of brain activity through sound. An extended presentation of the system can be found in this IFC 2020 paper . Mephisto Mephisto is a transpiler for converting sound patches designed using the graphical computer music environment Pure Data to the functional DSP programming language Faust. Faust itself compiles into highly-optimized C++ code. The aim of the transpiler is to enable creating highly optimized C++ code embeddable in games or other interactive media for sound designers, musicians and sound engineers. weather_organ Weather Organ is a Faust instrument for manipulating sparse noise to imitate slowly-changing natural sound sources such as rain, wind, surf, fire, Geiger counters and volcanic activity, and to create interesting new textures of sound. It is the product of various discoveries made while using Faust to explore the definition, synthesis and experience of acoustic noise while, simultaneously using the exploration of noise as as focus for learning Faust. Genius Eurorack Module The Genius is the next evolutionary step for the OWL platform, and the first product released based on a Cortex M7 microcontroller. It runs the OWL firmware and so can be programmed with Faust. A demo running bells from thee physical library can be listened to here . Dataflow Based FPGA Program Synthesis A Yale-NUS BSc. (Hons) in Mathematical, Computational, and Statistical Sciences Capstone: an FPGA Program Generator written in Python that takes dsp-sig XML Dataflow Graphs created using FAUST to produce FPGA programs in VHDL. DSPedal DSPedal is a custom hardware platform for real-time sound effects. It is operated by few knobs, external expression pedal, couple of buttons and a small graphical LCD. Processing effect is written in Faust programming language and compiled into C code. So far the Cortex M4 core clocked at 204 MHz has proven to be capable of executing relatively complex effects like wah, but effect-chaining quickly reaches the limits of processing power. Tambura Waveguide physical model of an Indian Tambura/Tanpura. This is a FAUST patch inspired by the Indian Tambura/Tanpura - a four string drone instrument, known for its unique rich harmonic timbre. The model uses a few tricks to produce a Tambura-like sound, and should probably be referred to as a \"pseudo\" physical model, because it does not attempt to accurately recreate the physics of the string-bridge interaction. It includes a range of parameters selected to allow control of the qualities of the excitation/pluck, string behavior and sympathetic resonance. It can produce some beautiful evolving drones, which can vary from very synthetic to quite natural. The model can be tested here . drumbox drumbox is a fun and powerful drum synthesizer for your Android device. Start from a preset and tweak the sounds and appearance to make it your own. Freestyle on the drum pads, record a sequence or both...it's up to you! Granola Granola is a monophonic granular live feed processor. The grain processor is inspired by the Mutable Instruments Beads. The grain window shape control is inspired by the GR-1 Granular synthesizer from Tasty Chips Electronics. The DSP code is written in Faust. fverb A stereo variant of the reverberator by Jon Dattorro coded in Faust. Sonification This study has been developed as a proof-of-concept for data pattern sonification. We've implemented data pattern sonification using FM synthesis coded in Faust. Air pollution data, which is temporal, is retrieved from the server and is done pattern mining. Then pattern data sonification is done. GULA Plugins A collection of guitar effect LV2 plugins ( The Vibey , The Splits , The Fades , SSaP Tone , Sweabed , Pequed , Peak audio to CV , LFO CV ) with MOD Devices user interfaces. limiterStereo Yet another look-ahead limiter code in Faust. The novel aspect of this limiter is that it uses N cascaded one-pole filters for amplitude profiling, which improves smoothness in the first to N-1 order derivatives and reduces total harmonic distortion. This design uses four cascaded one-pole lowpass filters, following the cut-off correction formula (8.9) found in [Zavalishin 2012]. Web Audio Modules Web Audio Modules are an open source framework facilitating the development of high-performance Web Audio plugins (instruments, realtime audio effects and MIDI processors). They can be developed using JavaScript and Web standards or compiled from C, C++ code, and domain-specific languages such as Faust or Csound. The Faust Web IDE contains an integrated GUI builder, read a tutorial here . Kapitonov Plugins Pack Set of 7 plugins for guitar sound processing, compiled in LADSPA and LV2 formats. Compatible with hosts such as Ardour, Qtractor, Carla, guitarix, jack-rack. The DSP of all of them is written in Faust. tubeAmp Designer Standalone software guitar processor, editor of *.tapf profile files for tubeAmp (KPP) and guitar amp profiler. BioSignals BioSignals is a data aquisition and processing device for EMG, ECG and EEG signals. Since it is using the OpenWare firmware, it can be programmed with Faust. Scale it Scale it is an open source program (written in graphical programming language Pure data and in Faust) that allows sonification of a signal distribution in real time. There are two different possibilities of sonification of the signal. One of the objects, tone, generates changes in pitch of a monophonic tone. The other object, chord, expresses the input value in width of polyphony. Scale it is being developed primarily for neurofeedback purposes. To allow straightforward and customizable instruments to carry sonic feedback about EEG activity in specific regions of the neocortex. JackTrip JackTrip is a Linux, macOS, or Windows multi-machine audio system used for network music performance over the Internet. It supports any number of channels (as many as the computer/network can handle) of bidirectional, high quality, uncompressed audio signal streaming. Several DSP effects ( compressor , freeverb , zitarev , limiter ) are written in Faust, compiled as C++ code, and included in project sources . Level Rider This is an audio plugin written in Faust that automates gain level adjustments, based on a target gain level, a time window over which overall loudness is calculated via RMS, and a maximum adjustment threshold. This plugin is comparable to Waves Vocal Rider or Waves Bass Rider in its functionality, but is free and open-source. Whetstone Transient Shaper A free, open source transient shaping audio plugin that operates on a specified frequency band. Whetstone will extract a certain frequency band based on a low cutoff and high cutoff that you choose, apply transient shaping to it, and then reintegrate the shaped band back into the original signal. This plugin is meant to be comparable to the excellent Spiff plugin in its core functionality, but lacks many of the nice features and polished UI. The DSP is coded in Faust . Reverb Trickery A free, open source audio plugin implementing various creative reverb effects, including octave-shifted, distorted, hi-pass/low-passed, gated, and narrowing reverb, coded in Faust . b259wf This is a model of the \"tibre\" circuit of the Buchla 259 Complex Wave Generator, made in Faust . The model follows the circuit modelling as seen on the paper Virtual Analog Buchkla 259 wavefolder , using 5 folds. The proposed 2-point BLAMP antialiasing method has been attempted for arbitrary sources as shown here , but it is not sufficient for high frequencies and/or more complex signals. Instead, filtering and light cubic nonlinearity distiorion has been used to round corners and for clipping. The user interface consists of the controls fold for the folding amount, offset for offseting the signal before folding, and lowpass as a final stage one-pole filtering to control the character (too much folding might introduce unwanted higher harmonics for certain signals). The final output is dc-blocked. string-machine This is a virtual-analog string ensemble synthesizer. The implementation is based on a digital model designed by Peter Whiting. The improvement of the model adds various abilities, in particular a virtual-analog emulation of the bucket brigade delay circuit. Most of the DSP code is developed using Faust. Three VST or LV2 are generated: string-machine , string-machine-chorus and string-machine-chorus-stereo . metaFx The metaFx is a control surface for continuous sound transformations in real time, just like the metaSurface64. Like metaSurface64 , it has both its own loop generator and a multi-effects FX engine, but its operation is different, especially for the management of plugin chains and pads. Each mixer on this surface can directly control the gain and the attached plug-ins. It is also possible to control the tracks of an external sequencer (Ardour or Reaper). To do this, the application uses OSC controllable modules that come from the Faust language library that is embedded in the application. Its interest lies in the construction of a parallel sound processing chain in the form of a graph. Kymatica.com Jonatan Liljedahl at Kymatica AB makes iOS music apps, electronic music, and a little bit of audio hardware. The following iOS applications have DSP code developed using Faust: AU3FX:Push : AUv3 dynamics processor with noise gate, compressor/expander with external side-chain input, brick-wall look-ahead limiter and hard/soft clipper. AU3FX:Space : High quality tweakable AUv3 reverb with resonant filters. For everything between small rooms, resonators, and infinitely large spaces. AU3FX:Dub : Stereo AUv3 delay effect for everything from clean digital delays to filthy dub echoes, ping-pong flangers, and broken cassette tapes. AUFX:PeakQ : A versatile 4-band parametric stereo equalizer for everything between subtle frequency enhancements and agressive boosting/cutting or special resonator effects. Nemesis Nemesis is multichannel dsp platform for eurorack. It can be programmed with Faust . Sonobus SonoBus is an easy to use application for streaming high-quality, low-latency peer-to-peer audio between devices over the internet or a local network. Several DSP effects ( Compressor , Expander , Limiter , ParametricEQ , Reverb ) have been written in Faust , compiled as C++ code, and included in the JUCE project . XPlugs.lv2 This repository contain the LV2 plugins developed using libxputty/XUidesigner. The included makfile allows the build of all plugins against a single checkout of libxputty. Each plugin exists as its own submodule under this repository. Some of the DSP code has been written with Faust. Bass Preamp Drive The goal of this project is to digitally reproduce the behavior of a well-known electric bass preamp: Ampeg SVT3 Pro. This preamp has been copied by several manufacturers. So we have an almost perfect copy with the Bugera BVP5500 which has four preamplifier tubes. An analog copy is also available as a pedal, the Tech 21 BDDI. The project is based on advances in the simulation of analog circuits made available by the Guitarix project and the excellent Faust from Grame cncm. Drum Module This project aims at integrating a digital drum synthesizer using Faust and Miosix real time OS on an STM32F407VG Discovery Board. To do this, a user interface by means of buttons, sliders, encoders, and an LCD has been implemented to control the synthesizer. Moreover, a serial MIDI input port has been added in order to control the synthesizer externally by using an external sequencer or controller. Daisy based audio boards Daisy is an embedded platform for music. It features everything you need for creating high fidelity audio hardware devices. Just plug in a USB cable and start making sound! No soldering required. It can be programed with Faust using the faust2daisy tool. Elk Audio OS Elk is an Audio Operating System developed from the ground up to deliver real time audio performances in embedded systems and remote networks. It can run on several hardware . Faust can be used to generate VST2 plugins to run on the plaform. ER-301 Sound Computer The ER-301 is a voltage-controllable canvas for digital signal processing algorithms. It can be programed with Faust using the faust2er301 tool and some units are developed here . Note that it is still a WIP, read the discussion here . Zynthian platform Zynthian is a new class of musical device. A powerful multitimbral synthesizer and audio processor, capable of managing up to 16 audio chains simultaneously. Also, it's a MIDI processor and router, equipped with standard MIDI ports, USB, WIFI & wired networks. Zynthian is a community-driven project and it's 100% open source. The Zynthian platform can be programmed with Faust with some DSP examples here . GxPlugins.lv2 GxPlugins.lv2 is a set of more than 40 extra standalone lv2 plugins designed to compliment the Guitarix project. Each plugin exists as its own submodule under this repository. The DSP code has been written with Faust. Stone phaser A classic analog phaser effect. This is an analog phaser with similarity to the Small Stone. It has a color switch, which makes the phasing stronger when on, and adds some feedback controls. A stereo variant of the phaser is included. This effect is supported on MOD devices. The DSP code is developed in Faust . sfizz sfizz is a sample-based musical synthesizer. It features the well-established SFZ instrument format at its core, which permits to use existing instrument libraries, or create personal instruments with ease. Not only is sfizz ready-to-use as an instrument plugin of its own, the library allows developers to create instruments of their own, taking advantage of the abilities of SFZ. The sfizz project uses the SFZ parser and synth c++ library, providing AU / LV2 / VST3 plugins and JACK standalone client. Some effects are developed in Faust are well as several filters . Antescofo Antescofo is a coupling of a real-time listening machine with a reactive and timed synchronous language developed at IRCAM . The language is used for authoring of music pieces involving live musicians and computer processes, and the real-time system assures its correct performance and synchronization despite listening or performance errors. Antescofo audio DSP processes can be described with Faust , using libfaust dynamic version of the Faust compiler. Motion Vox A mobile music creation and performance workstation with a built-in motion-based controller, sequencer and synthesis engine. The controller unites XY pad, accelerometer and gyroscope events with complex data \ufb01ltering engine. Performance process consists of touching the active area on the screen with the index finger and moving the cursor while moving the device in space. Smartphone position in space and finger movement on a screen affect various parameters of sound or generate realtime MIDI output. The app was inspired by the SmartFaust project of GRAME. The audio engine of the app is made with FAUST. INScore INScore is an open source framework for the design of interactive, augmented, live music scores. Augmented music scores are graphic spaces providing representation, composition and manipulation of heterogeneous and arbitrary music objects (music scores but also images, text, signals...), both in the graphic and time domains. Audio DSP processes and effects can be described using Faust. The environment runs as a native application but also in the Web. Faust programs are only supported by the online version . Virtual Rhizome By Vincent Carinola . Virtual Rhizome responds to a proposal by Christophe Lebreton and Jean Geoffroy to compose a work for the original Smart Hand Computer system, developed at the GRAME-CNCM using the Faust language and allowing to play smartphones as an instrument. The work takes the form of a labyrinth, a kind of virtual architecture that could be compared to Borges' \"garden of branching paths\", within which the musician evolves by adapting his gestures to the constraints of different types of situations. Each situation is characterized by an autonomous functioning of the system, that the musician must apprehend in order to find the key allowing him to modify it and to move towards another situation. But in order to orientate himself well, he must create a mental representation of the structure of the work. The performer then becomes an explorer of a world that he unveils, but isn't that what he has always been? Virtual rhizome owes much to the availability and enthusiasm of Jean Geoffroy and Christophe Lebreton. It is amicably dedicated to them. SmartFaust SmartFaust is a concept of musical applications for smartphones. These applications have the particularity of only using the user's gestures and not by tapping on the device's screen. Made for iOS and Android, they can also use the motion sensors of these devices to make them real musical instruments. Smartfaust applications are based on the Faust (Functional Audio Stream) programming language developed by Grame over the last 15 years and recognized as a standard in the field of real-time signal processing for audio. The SmartFaust applications were first used for the creation of the pieces Mephisto (for drums and cell phone ensemble), Belzebuth (participative piece for public equipped with Smartphones), Iblis (for clarinet and cell phone ensemble) and B\u00e9lial (for harp and cell phone ensemble) written by the composer Xavier Garcia. From this same technology were later created the applications \"Geek Bagatelles\" (2016) and \"GameLan\" (2019). Download here: Android & iOS Trombone Simulator This simulator is a physical model of a trombone. Physical models of the lips, mouthpiece, slide, and bell are digitally simulated. The controls are listed at the top. The main controls are to move the cursor (or your finger on a touch device) left and right on the picture to adjust the embouchure, and up and down to extend and retract the slide. The diagonal colored lines are a guide to where the resonances are: playing over a resonance means that the embouchure and slide length are matched. Playing over white space means that one is between resonances and the note quality won't be as good. The big gray wedge on the upper right indicates that the resonances are very close together there. The vertical dashed lines indicate the rough locations of B-flat (thick lines) and F (thin lines). Other notes are unmarked, and likewise the slide positions. (Just like on a real trombone!) The off-key resonances (7th, 11th, 13th, and 14th) are marked in red. The g and f keys can be used to growl and flutter-tongue, respectively. The audio simulation is written in Faust, which conveniently compiles to WebAssembly and a Web Audio API wrapper. The overall approach used was a digital waveguide model, as described in J. O. Smith III's Digital Waveguide Theory. The lips and bell are adapted from F. Scott's masters thesis. Integrating 1-DoF force feedback interactions in self-contained DMIs By Mathias Kirkegaard . This thesis presents a system for designers of Digital Musical Instruments (DMIs) to explore the integration of 1 degree of freedom (DoF) force feedback interactions in new self-contained instruments. The system developed consists of an open-source graphical tool and a rotary force-feedback device made from commercially available components to facilitate the authoring of audio-haptic applications. Implementing an early prototype is used to inform the development of the graphical editing tool and its integration in an embedded audio-haptic environment using the functional programming language Faust for real-time signal processing. Beyond Key Velocity: Continuous Sensing for Expressive Control on the Hammond Organ and Digital Keyboards By Giulio Moro . In this thesis we seek to explore the potential for continuous key position to be used as an expressive control in keyboard musical instruments, and how pre- existing skills can be adapted to leverage this additional control. The nonlinear waveguide physical model of a flute has been developed in Faust. Guide de la synth\u00e8se sonore By Sebastien Clara . In this guide, I try to demystify how sound synthesis works. To do so, I present the fundamental principles of sound synthesis. I accompany these explanations with small sound applications that you can manipulate in your web browser and thus, you will be able to notice the impact of a parameter on the sound. Most of the sound examples are written in Faust and run in the web pages. This guide is currently only in french. PICO DSP PICO DSP is an open-source, Arduino-compatible ESP32 development board for audio and digital signal processing (DSP) applications. It offers an expansive audio-processing feature set on a small-format, breadboard-friendly device that provides audio inputs, audio outputs, a low-noise microphone array, an integrated test-speaker option, additional memory, battery-charge management, and ESD protection all on one tiny PCB. The board can be programmed using Faust . Soundjack The Soundjack realtime communication application is extended by a server cloud to handle up to 60 musicians of an orchestra, developed with the Faust programming language. Each musician is connected to a Soundjack UDP client. An individual stereo mix of the multiple audio streams originating from the multiple Soundjack clients has to be provided to each listening musician. An extended presentation of the system can be found in this IFC 2018 paper . studiox-switcher Studiox-switcher is an input switcher and silence detector for JACK. It can switch between 3 stereo inputs, a fallback channel is activated if the active input is below a volume threshold for some amount of seconds, and channels may be switched via OSC and HTTP. The core DSP engine is done via Faust for switching, silence detection and level metering. SynthSpace Synthspace is the ultimate virtual synthesizer. It combines the familiarity of real instruments with the possibilities of virtual worlds. Nodes for Synthspace can be developed in Faust . Bass21 This VST3 is a virtual-analog simulation of the famous Bass Driver DI Version 1 preamp pedal from Tech21. The discretization, while far from being exact, is moderately close to the original. The potentiometers are identical to these physically present on the BDDI pedal, apart from the pregain which is specific to this digital version. The DSP code is written in Faust. EchoMatrix The EchoMatrix was designed to provide some of the functionality of the Yamaha UD Stomp pedal as used be Alan Holdsworth. This project will be submitted to the KVR Developer Challenge 2021 contest to highlight the power of the Faust DSP development environment and the JUCE framework to create a non-trivial effect VST3 using a managable amount of Faust DSP code . The Striso board The Striso board is a very expressive music instrument which combines multidimensionally sensitive keys with an innovative note layout that helps understand the structures in music. The keys capture each subtle finger movement, which allows for levels of musical expression previously only known to acoustic instruments. Additionally, accents and sound effects can be added by shaking and moving the instrument as a whole. The internal sound is written in Faust, and is controlled directly by the signals from the keys and motion sensor. External synthesizers can be controlled using MPE MIDI, or using OSC which is easier to set up for Faust synthesizers. The firmware source code is released as open source. Live concatenative granular processing This algorithm addresses signal discontinuity and concatenation artefacts in real-time granular processing with rectangular windowing. By combining zero-crossing synchronicity, first-order derivative analysis, and Lagrange polynomials, we can generate streams of uncorrelated and non-overlapping sonic fragments with minimal low-order derivatives discontinuities. The resulting open-source algorithm, implemented in the Faust language, provides a versatile real-time software for dynamical looping, wavetable oscillation, and granulation with reduced artefacts due to rectangular windowing and no artefacts from overlap-add-to-one techniques commonly deployed in granular processing. fb_suppression ALS - Automatic Larsen Suppression algorithms implementing adaptive filtering through spectral centroid calculation, and adaptive frequency shifting through RMS calculation. ossia score Ossia score is a sequencer for audio-visual artists, designed to enable the creation of interactive shows, museum installations, intermedia digital artworks, interactive music and more in an intuitive user interface. Faust can be used to create advanced audio processes . A demo video of the Faust integration can be seen here . FASELUNARE Microcosmos Microcosmos is a small open-source electronic board, developed by \u200bFaselunare (Italy), aimed at prototyping electronic musical instruments and learning electronics, microcontroller programming and audio DSP, and programmable with Faust. A demo video of the project can be seen here . The project has been presented at ADC21 . Audio Anywhere The goal of Audio Anywhere is to explore the idea of compile once, run anywhere for audio DSP code. Audio Anywhere combines Faust, for audio DSP code, and HTML5 to enable development of modern audio synthesis and effects tools. There are currently three main repos for this work: AA examples AA standalone app AA Wasmtime runtime The KeyWi An Expressive and Accessible Electronic Wind Instrument, where the sound is synthesized with Faust running on the Bela Mini processing board. React Web Audio Guitar Studio React Web Audio Guitar Studio is an online real-time Web Audio based all-in-one guitar studio, using native plugins written on Faust, compiled on-demand, and ran in a browser. JSPatcher JSPatcher is a Visual Programming Language (VPL) in Max/PureData style on the web with following features: Patch WebAudio native AudioNodes Play with JavaScript Web APIs Import and patch external JavaScript modules Customize AudioWorklet DSPs with Faust A presentation video can be seen here . Gwion Gwion is a programming language aimed at making music. It is strongly inspired by ChucK and can use a set of plugins for Gwion . One allows to use the libfaust library to JIT compile and run DSP code on the fly. The faust2gw tool allows to produce statically compiled modules. sonejostudios A set of tools written using Faust. Panoramix Stereo Panorama/Balance and Volume Automation Tool. Mixer4x A simple 4-channel stereo mixer. The main goal is to use it as a submixer on a 4 channel track, but you can use it everywhere you need a small 4 channel stereo mixer. faustdrumseq A very simple drum sequencer written with Faust, using the new soundfile object. MidiClockClick A simple metronom driven by MidiClock. SuperBeatRepeater Beat Repeater with Sidechain Beat Recognation and Midi-Clock Sync. Very useful i.e to add musical diversity by looping short parts of the stream (i.e drums). SuperCutSequencer Cut \"On/Off\" Sequencer (8 steps with smooth) synced to Midi-Clock Beats and Midi-Clock Start/Stop. Very useful i.e to add musical diversity in looped tracks (very nice with i.e bass lines). DeLooper Sample-accurate Looper/Delay with free mode and midi-clock sync mode. XYMatrix XY Surround Matrix for one Source (Mono Input) with 4 Outputs (Left, Right, Surround Left, Surround Right) and Position Lock. stm32-faust-synth STM32 synthesizer video is a short presentation of a polyphonic synthesizer based on STM32F405 \u00b5C. Faust is used for signal processing and a TLV320AIC23B stereo codec serves as DAC. Another more recent video is here . faustgen2~ The faustgen2~ object is a Faust external for Pd a.k.a. Pure Data , Miller Puckette's interactive multimedia programming environment. Amati Amati is a VST plugin for live-coding effects in the Faust programming language. As of now it only provides basic functionality. PureTones PureTones PureTones is a family of software tools for Indian Classical music. They are built based on an in-depth study and exploration of Indian Classical music to understand the role of harmonics, microtones and consonance in Indian Ragas and musical scales: PureTones Drone (using first tab) , is a digital Tanpura with controls for fine tuning the strings and adjusting their harmonic envelope. PureTones Musical Scale (using second tab) is a digital 12 note keyboard with controls for fine tuning each key to be consonant with an accompanying drone track. PureTones Sequencer (using third tab) is a sequencer which enables composition of melodies and musical works in Indian Classical music using notes from a fine tuned musical scale. The Ragatronics project combines Ragas from Indian Classical music with elements from Rock, Jazz and Electronic music. All applications have been developed using Faust and WebAudio tools. Making Sound Machines Making Sound Machines are a duo of makers from D\u00fcsseldorf, Germany. We build kits, modules and DIY projects, and use the projects we\u2019ve built to make music. Faust is used in several projects. master_me Automatic audio mastering plugin for live-streaming, podcasting and internet radio stations. With the first Covid-19 related lock-downs in 2020, many real-life concerts, conferences and festivals were forced into the digital domain - and sounded pretty crappy. Having worked for almost 20 years in audio mastering, Berlin based engineer Klaus Scheuermann started to develop master_me - a word fusion of automatic mastering and mini-me - in order to make open source streaming sound better. After a few weeks of learning and development, master_me was first used at the 'Quarantine Sessions' - a weekly distributed electro-acoustic improvised concert, hosted at Stanford's CCRMA Institute. master_me was developed further to be an easy-to-use tool for all live streaming applications. In 2022 it was funded by the Prototype Fund, an open source software funding initiative by the german ministry of education and research. A stable release is available since September 2022. metaSurface64 metaSurface64 is a real-time continuous sound transformation control surface that features both its own loop generator for up to 64 voices and a multi-effects FX engine. The application embeds the libfaust dynamic version of the Faust compiler. Fragment Audio Server and Fragment Fragment Audio Server (FAS) is a high performance pixels-based graphical audio synthesizer implemented as a WebSocket server with the C language (C11). Faust , is embedded (when compiled with WITH_FAUST ) and allow to dynamically extend FAS bank generators and effects with custom one written with the Faust DSP specification language. FAS is the audio engine used in Fragment , the Collaborative Graphical Audio Synthesizer. Follow the demo here . Swanky Amp Swanky Amp is a tube amplifier simulation DSP plugin which aims to capture the details in the dynamics of tube amplifiers. The DSP is primarily written in Faust , whereas the UI is written in C++ using the JUCE . Follow the demo here . A commercial version is available here . Web Synth This is a web-based DAW (Digital Audio Workstation) written in Rust/WebAssembly and TypeScript with extensive Faust language integration with dynamic remote code compilation and executing via WebAssembly. Follow the demo here . DawDreamer DawDreamer is an audio-processing Python framework supporting core DAW features such as audio playback, VST MIDI instruments, VST effects, Faust , and parameter automation. DawDreamer is written with JUCE , with a user-friendly Python interface thanks to pybind11 . DawDreamer draws from an earlier VSTi audio \"renderer\", RenderMan . TD-Faust TD-Faust enables Faust code to run inside TouchDesigner . Follow the demo here . Mephisto LV2 Mephisto LV2 a Just-in-Time Faust compiler embedded in an LV2 plugin. Write LV2 audio/cv instruments/filters directly in your host in Faust DSP language without any need to restart/reload host or plugin upon code changes. iPlug2 iPlug 2 is a simple-to-use C++ framework for developing cross platform audio plug-ins/apps and targeting multiple plug-in APIs with the same minimalistic code, support for the Faust programming language, and the libfaust JIT compiler. pMix pMix (short for preset mixer) is a sound design, composition and performance tool that facilitates the control of multiple parameters using an intuitive graphical interface. It includes a graphical patcher for creating a network of audio synthesis or processing nodes. A node could be a VST2, VST3, AU or LADSPA plug-in or it could a JIT compiled FAUST script. FAUST is a first class citizen in pMix and an integrated code editor and SVG display makes it a nice environment for FAUST development. Temper JUCE plugin Temper is a digital distortion audio plugin targeting VST, VST3, and AU for OS X and Windows. It builds upon traditional waveshaping techniques using modulated filter coefficients to produce a unique phase distortion. The primary signal processing loop is written with Faust, and compiled with JUCE for the various build targets. Faust Mass-Interaction mi_faust implements 1D mass-interaction models in the FAUST programming language. Starting from a scripted model description (see MIMS), mi_faust compiles a physical model into FAUST code. It handles this by generating routing functions between all the masses and all the interactions in the model. Head over to the FAUST community page to see examples of a series of instruments created in mi_faust, and available as web-apps ! Dynamic PedalBoard Dynamic PedalBoard allows users to plug different stompboxes together in a web browser. SHARC DSP Board The ADI SHARC DSP board fully supports Faust. Nuance Nuance is a pressure sensitive music controller that uses Faust for sound synthesis and processing. The PlateAxe The PlateAxe is a percussion instrument physical model controller using Faust for sound synthesis and processing. The BladeAxe The BladeAxe is an electric guitar physical model controller using Faust for sound synthesis and processing. Bart Brouns' Projects A collection of projects by Bart Brouns and based on Faust. EarTone Toolbox The Ear Tone Toolbox is a collection of unit generators for the production of auditory distortion product synthesis. AudioKit AudioKit allows developers to quickly add professional audio functionality to iOS, macOS, and Apple Watch apps. Radium Radium is a music editor with a new type of interface. It includes a Faust audio DSP development environment. Compared to the normal sequencer interface editing is quicker and more musical data fits on the screen. Compared to trackers, note positions and effects are edited graphically, which should be quicker, provide more vertical space and give a better musically overview. (Everything can also be edited by text, like in a normal tracker) Radium can also be used as a normal multitracker to mix and record audio. BELA Bela is a maker platform for creating beautifully responsive audio and interactive applications. Designed for artists, musicians, researchers and makers, Bela brings the power of ultra-low latency interactive audio and sensors to your digital projects. It can be programmed with Faust . HOA Library HOA Library allows musicians and composers to synthesize, transform and render sound fields in a creative and artistic way. This library facilitates the understanding and the appropriation of key concepts of ambisonics. Thanks to original graphical interfaces a lot of new signal processings are allowed like diffuse sound field synthesis, perspective distorsion or spatial filtering. HOA library is open-source and free and offers a set of C++ and FAUST classes and implementation for Max, PureData and Unity. Ambitools Ambitools is a collection of plug-ins and tools for 3D sound field synthesis using Higher Order Ambisonics (HOA). The plugins are written in the Faust language , which allows them to be compiled for a multitude of architectures and platforms (Windows, Mac, Linux, WebAudio, embedded systems, etc.) Moreover, the code is written in a scalable way: there is no limit to the maximum Ambisonic order! Other tools are also available, such as a 3D Visualizer written in the Processing language. Ambisonic Decoder Toolbox The Ambisonic Decoder Toolbox is a collection of MATLAB and GNU Octave functions for creating Ambisonic Decoders. Currently, it implements: (1) the AllRAD design technique, (2) inversion or mode-matching, (3) truncated mode-matching, constant energy, (4) linear combinations of 2 and 3, and (5) Slepian function basis (EPAD). The DSP code is written in MATLAB and Faust. Ambisonic.xyz A set of tools around Ambisonics. FaustPy FaustPy is a Python wrapper for Faust. It is implemented using the CFFI and hence creates the wrapper dynamically at run-time. Rebel Technology The OWL Pedal is an open source, programmable stage effects pedal, made for guitarists, musicians, hackers and programmers. Users can program their own effects, or download ready-made patches from our growing online patch library. faust-vst This project provides a VST plugin architecture for the Faust programming language. The package contains the Faust architecture, faustvst.cpp, the faust2faustvst helper script which provides a quick way to compile a plugin, a collection of sample plugins written in Faust, and a generic GNU Makefile for compiling and installing the plugins. faust-lv2 This project provides an LV2 plugin architecture for the Faust programming language. The package contains the Faust architecture and templates for the needed LV2 manifest (ttl) files, a collection of sample plugins written in Faust, and a generic GNU Makefile as well as a shell script to compile plugins using the architecture. RDK Reverb Design is about creating a spacial impression aimed at sweetening the listening experience for a given context. The ambiguity of auditory and visual cues in reproduced sound makes it necessary to create an auditory illusion: To make this illusion work, I propose an aesthetic concept of simplicity and intelligibility based on psychoacoustic facts and recording practice as professional producer. Foo YC20 The Foo YC20 is an open source implementation of the Yamaha YC-20 combo organ from 1969. Processing for the organ is based on original schematics and measurements from a working specimen. This instrument simulates the circutry as a whole to realisticly reproduce the features and flaws of the real deal. FaucK FaucK is a Chugin allowing to combine the powerful, succinct Functional AUdio STream (Faust) language with the strongly-timed ChucK audio programming language. FaucK allows programmers to on-the-fly evaluate Faust code directly from ChucK code and control Faust signal processors using ChucK's sample-precise timing and concurrency mechanisms. The goal is to create an amalgam that plays to the strengths of each language, giving rise to new possibilities for rapid prototyping, interaction design and controller mapping, pedagogy, and new ways of working with both Faust and ChucK. Snd-RT Snd-RT is the realtime extension for the sound editor SND and consists of two parts: the RT Engine - An engine for doing realtime signal processing. the RT Compiler - A compiler for a scheme-like programming language to generate realtime-safe code understood by the RT Engine. Pure Language [Pure is a modern-style functional programming language based on term rewriting. It offers equational definitions with pattern matching, full symbolic rewriting capabilities, dynamic typing, eager and lazy evaluation, lexical closures, built-in list and matrix support and an easy-to-use C interface. The interpreter uses LLVM as a backend to JIT-compile Pure programs to fast native code. It has been created by Albert Gr\u00e4f. pd-faust is a collection of Pd objects written using pd-pure which lets you run Faust programs inside Pd. It combines the functionality of pure-faust and faust2pd in a single package, and also features dynamic reloading of Faust plugins, automatic generation of controller GUIs and MIDI/OSC controller mappings, as well as OSC-based controller automation. It thus provides a complete solution for interactively developing Faust dsps in Pd. Guitarix An audio plug-in for guitar effects whose sound processing engine is written in Faust. moForte GeoShred An electric guitar app using physical modeling. Faust was used to implement its sound synthesis/processing engine. moForte PowerStomp An app implementing various guitar effects to be used on stage. moForte Guitar An app that can be used as an electric guitar and whose sound synthesis engine is implemented in Faust. FaustWorks FaustWorks is an IDE (Integrated Development Environment) for the Faust dsp programming language. You must have Faust installed to be able to use FaustWorks. Platforms supported are Linux and OSX. FaustLive FaustLive is an advanced self-contained prototyping environment for the Faust programming language with an ultra-short edit-compile-run cycle. Thanks to its fully embedded compilation chain, FaustLive is simple to install and doesn't require any external compiler, development toolchain or SDK to run. FaustLive is the ideal tool for fast prototyping. Faust programs can be compiled and run on the fly by simple drag and drop. They can even be edited and recompiled while running, without sound interruption. It supports also native applications generation using the Faust online compiler. FaustLive is based on the Faust library and on LLVM. \u200b","title":"Powered By Faust"},{"location":"community/powered-by-faust/#powered-by-faust","text":"This page lists the projects using Faust in different ways: musical pieces or artistic projects, plugins or standalone applications, integration in audio programming environments, development tools, commercial applications, research projects (possibly non musical), embedded devices, Web applications, etc.","title":"Powered By Faust"},{"location":"community/powered-by-faust/#polyblep-hole","text":"A Faust collection of externals for Pure Data stuck together on the Organelle . The polyBLEPs are the work of Jacek Wieczorek. v1.1 triples the oscillators as sounded a bit thin. The greyhold reverb is immense.","title":"polyBLEP HOLE"},{"location":"community/powered-by-faust/#onetrick-keys","text":"A physically modeled piano synth with a chill lo-fi sound. It uses a vintage algorithm developed at Stanford in 1995 called \"Commuted Piano Synthesis\", and runs that through studio reverb, vinyl or tape noise, flutter, bitcrushing, and saturation. The project is using Rust and the Faust to Rust backend, and the source code is available .","title":"OneTrick KEYS"},{"location":"community/powered-by-faust/#mod-audio","text":"The compact and powerful standalone guitar effects ecosystem to express your creativity at home, in the studio and on stage, which can be programmed with Faust .","title":"MOD Audio"},{"location":"community/powered-by-faust/#nih-faust-jit","text":"A plugin to load Faust dsp files and JIT-compile them with LLVM. A simple GUI is provided to select which script to load and where to look for the Faust libraries that this script may import. The selected DSP script is saved as part of the plugin state and therefore is saved with your DAW project.","title":"nih-faust-jit"},{"location":"community/powered-by-faust/#ambientgarden","text":"ambient.garden is a musical landscape in a website, developed using Teasynth with these Faust codes . All the music in ambient.garden is generated from code. The music is then laid out in a landscape which can be explored, either interactively, or automatically when the autopilot is left on.","title":"ambient.garden"},{"location":"community/powered-by-faust/#teasynth","text":"Teasynth is a tool to make music with code in Javascript, Faust and Sporth . There are two main ways of using it: The web editor runs in the browser and provides an instant composition environment. The command line interface can render music to audio files, serve the editor locally, and bundle music code.","title":"Teasynth"},{"location":"community/powered-by-faust/#lich","text":"Technology OWL platform that allows you to use Pure Data, Max Gen or Faust code into your module!. Lich is a Befaco Rebel collaboration that brings back Owl\u2019s platform with this new hardware iteration. It has stereo in and out, four pot controls summed to cv inputs (like the classic Owl module) And as addition, CV and Gate outputs, patch selection with display and USB MIDI host and device connections.","title":"LICH"},{"location":"community/powered-by-faust/#lamb","text":"A lookahead compressor/limiter that's soft as a lamb, written in Faust and Rust. Lamb was made with these goals in mind: Be as clean as possible Give the user full control over the character with the minimum amount of knobs.","title":"lamb"},{"location":"community/powered-by-faust/#faustsynth","text":"Welcome to FaustSynth, a AU/VST monophonic synthesizer built with the Faust programming language. This is the project deliverable for PAT 481: Independent Study in Fall 2023.","title":"FaustSynth"},{"location":"community/powered-by-faust/#envelopforlive","text":"The nonprofit mission of Envelop is to connect and inspire community through immersive listening. Our listening spaces envelop the audience in pristine 3D sound, amplifying the power of music and nurturing our ability to listen together. Some Max/MSP externals are written in Faust .","title":"EnvelopForLive"},{"location":"community/powered-by-faust/#rcverb-reaclassical-verb","text":"A reverb suitable for classical music based on zita-rev1. Available as LV2 and CLAP by default (with optional VST3, VST2 and LADSPA). This plugin is part of the ReaClassical project along with RCComp (\"ReaClassical Compressor\") and Enover (RCVerb's big sister) additionals plugins, also written in Faust.","title":"RCVerb (\"ReaClassical Verb\")"},{"location":"community/powered-by-faust/#wam-studio","text":"Wam-Studio\u2019s is an online tool for creating audio projects that you can imagine as multi-track music. Each track corresponds to a different \"layer\" of audio content that can be recorded, edited, or just integrated (using audio files for example). Some track can be used to control virtual instruments: in that case we record the sound that is generated internally by these virtual instruments (and played using a MIDI piano keyboard, for example). Tracks can be added or removed, played isolated or with other tracks. They can also be \"armed\" for recording, and when the recording starts, all other tracks will play along, while the armed track will record new content. Wam-Studio can host WAM plugins and in particular Faust ones , which can be built following this tutorial .","title":"Wam-Studio"},{"location":"community/powered-by-faust/#snes-echo-simulator","text":"SNES Echo is an cross-platform audio processing plugin, written in Faust. It simulates the SNES SPC700 DSP reverb/echo effect. This plugin does not strive for bit-accuracy and overflow handling, but instead being audibly indistinguishable for \"normal\" SPCs.","title":"SNES Echo Simulator"},{"location":"community/powered-by-faust/#syfala-project","text":"Automatic compilation of Faust audio DSP programs for AMD-Xilinx FPGAs, developed by the Emeraude team , and funded by the FAST ANR project. Supported board models are: Digilent Zybo Z7-10 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Zybo Z7-20 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Genesys ZU-3EG - Zynq UltraScale+ MPSoC Development Board","title":"Syfala project"},{"location":"community/powered-by-faust/#interactive-granular-texture-synthesiser","text":"An interactive granular texture synthesiser built in TouchDesigner, utilising real time signal processing of the domain-specific language Faust (functional audiostream), and the corresponding TD_Faust operator.","title":"Interactive Granular Texture Synthesiser"},{"location":"community/powered-by-faust/#reflex-in","text":"Reflex-in is a sound installation that uses brain-wave streams to create music composition within the Web environment in real time. The work incorporates various state-of-the-art Web technologies, including Web Audio, WebSocket, WebAssembly, and WebGL. The music generated from the algorithm - mapping brain wave signal to musical events - aims to produce a form of furniture music that is relaxing and meditative, possibly therapeutic. The synthesizer part is created from Faust DSP and the installation can be tested here .","title":"Reflex-in"},{"location":"community/powered-by-faust/#faustcgp","text":"Generate new audio synthesizers and filters in FAUST with Recurrent Cartesian Genetic Programming. Given a target sound or impulse response as input, the RCGP will return a FAUST synthesizer or filter, respectively, that best approximates the given signal or impulse response. Samples for an early version of the software can be found here .","title":"FaustCGP"},{"location":"community/powered-by-faust/#onetrick-urchin","text":"A hybrid drum synth that models the gritty lo-fi sound of beats from vintage records without sampling. It takes spectral and physically modeled drums, running them through simulated studio reverb, a vinyl or tape player, and finally a digital sampler. The result is a fat and saturated drum machine that creates a vibe of sampling with the control of a synthesizer. The project is using Rust and the Faust to Rust backend, and the source code is available .","title":"OneTrick URCHIN"},{"location":"community/powered-by-faust/#kbverb","text":"A Faust reverb, based on the Midiverb architecture by Keith Barr .","title":"KBVerb"},{"location":"community/powered-by-faust/#pasfa-paste-faust-code","text":"A paste service for Faust code, to be tested here .","title":"pasfa - Paste Faust code!"},{"location":"community/powered-by-faust/#faustmapper","text":"FAUSTmapper is a tool for binding popular Digital Musical Intrument (DMI) mapping tools to the FAUST ecosystem. The default action for the FAUSTmapper project is establishing a binding to the libmapper project. When the script is run, the entire parameter space of an active FAUST project (with HTTP control enabled) will be discovered. Once discovered, a libmapper signal will be created for each of the parameters identified, including appropriate meta data such as min, max & default values. The following poster was presented at the 4th Annual International Symposium on the Internet of Sounds and was awarded the Best Poster Award.","title":"FAUSTmapper"},{"location":"community/powered-by-faust/#phausto","text":"Pharo is a pure object-oriented programming language and a powerful environment, focused on simplicity and immediate feedback (think IDE and OS rolled into one). Phausto allows to use Faust inside Pharo.","title":"phausto"},{"location":"community/powered-by-faust/#cantor-digitalis","text":"The Cantor Digitalis is a singing voice synthesiser controlled in real time by chironomy, i.e. by manual gesture, using interfaces such as a stylus or the fingers on a graphics tablet. More generally, it can be controlled using any MIDI interface. The synthesiser has been reimplemented in Faust by Gr\u00e9goire Locqueville during his PhD thesis .","title":"Cantor Digitalis"},{"location":"community/powered-by-faust/#karya","text":"Karya is a score language editor with support for scales, instrumental techniques, and ornaments, with special support for Balinese, Javanese, and Carnatic music. It has backends for MIDI, supercollider OSC, lilypond, and an incremental audio renderer that uses Faust or samples. You can write instruments in Faust and integrate them into a score along with samples and MIDI instruments. Due to incremental rendering, even computationally expensive instruments are not a problem.","title":"Karya"},{"location":"community/powered-by-faust/#body-brain-digital-musical-instrument-bbdmi","text":"BBDMI project aims at making music from electrical signals of the muscle and the brain using EMG and EEG technologies. Producing instrumental prototypes in an open way (open software and open hardware) and to document them in the framework of open science (FAIR). The modular system is built with Max/MSP and interfaced with Faust for the purpose of analyzing, processing and mapping electrophysiological signals to sound. The paper An Interactive Modular System for Electrophysiological DMIs received a best paper award at Audio mostly 2023 .","title":"Body Brain Digital Musical Instrument (BBDMI)"},{"location":"community/powered-by-faust/#the-spatbox","text":"The Spatbox is an interface to intuitively generate 3D trajectories and to spatialize them in real-time on a loudspeaker array with Ambisonics, developed by Pierre Lecomte . Each trajectory is described by a parametric curve, where each of the coordinates varies according to a configurable LFO. Depending on the LFO parameters, many trajectories can be generated. The implementation is done in Faust and the project has been presented at PAW 2022 .","title":"The Spatbox"},{"location":"community/powered-by-faust/#muss3640-vocal-synthesiser","text":"The MUSS3640 Vocal Synthesiser is a standalone application/VST3 plugin developed to allow exploratory synthesis of the singing voice. It implements a combination of formant-wave-function and bandpass synthesis techniques. The DSP is written in Faust.","title":"MUSS3640 Vocal Synthesiser"},{"location":"community/powered-by-faust/#riti-room-is-the-instrument","text":"RITI: Room Is The Instrument by Luca Spanedda , is a piece based on a complex system capable of manifesting emergent and chaotic behaviors, where the acoustic personality of an environment (digital or physical) becomes a case of study for the performance and is reflected in terms of variation in the behavior of the system itself. The DSP code is written in Faust. See a video of a \"studio\" performance of the system .","title":"RITI: Room Is The Instrument"},{"location":"community/powered-by-faust/#equis","text":"EQUIS is a 4 Channel DJ Mixer built on top of JACK. It's EQ is inspired by the Playdifferently Model1 and offers per channel a highpass, lowpass and sculpt eq. The code is developed in Rust and the DSP is written in Faust . See the video presentation at Sonoj convention .","title":"EQUIS"},{"location":"community/powered-by-faust/#esp32-wrover-eie-audio-dev-board","text":"A board to play with FAUST sound synthesis language.","title":"ESP32 Wrover E/IE audio dev board"},{"location":"community/powered-by-faust/#kuroscillators","text":"Max/MSP objects for audio and rhythmic synthesis using coupled oscillator networks. Coupled Oscillators networks are dynamical systems that describe how ensembles of interacting elements are able to self-organize and synchronize over time. In terms of sensory perception, they have been examined in a wide range of fields including those related to rhythmic entrainment, biomusicology, psychoacoustics, signal processing, and generative music. The DSP is written in Faust .","title":"Kuroscillators"},{"location":"community/powered-by-faust/#joue-music-instruments","text":"A new way to make music: the Jou\u00e9 Play is a system that combines an expressive multi-instrument, an intuitive app & interactive content, with a range of musical instruments that use touch-sensitive technology to create a unique playing experience. These instruments are designed to be highly expressive, allowing musicians to play with greater nuance and emotion. Part of the audio effects are coded in Faust.","title":"Jou\u00e9 Music Instruments"},{"location":"community/powered-by-faust/#externalchugins","text":"Chugins , short for \"ChucK plugins,\" are plugins for the ChucK programming language . ChucK is an audio programming language that allows for real-time synthesis, composition, and performance of music. Chugins extend the functionality of ChucK by providing additional classes, objects, and modules that can be used to create more complex and intricate music and sound designs. ExternalChugins are a set of chugins exported from Faust.","title":"ExternalChugins"},{"location":"community/powered-by-faust/#mesh2audio","text":"Generate axisymmetric 3D models, or import existing 3D models, and transform them into real-time playable physical audio models! Supports fast DSP generation of physical audio models that sound decently realistic, as well as blazing fast 2D axisymmetric model generation, at the expense of some fidelity. It is an improvement of the mesh2faust tool. The generated audio model can be played in real-time by \"striking\" (clicking) on mesh vertices in the 3D mesh viewer.","title":"mesh2audio"},{"location":"community/powered-by-faust/#onetrick-cryptid","text":"Whispers of a dreaded drum machine with the cold clanging heart of a DX7 in the fearsome frame of a TR-808 echo in dusty backrooms of backstreet recording studios. A contraption conjured under cover of darkness in the heinous pursuit of chart topping tracks, known only as the DX-808. It's time to bring the beast out of the shadows! Allow us to present the world's most accurate recreation of an FM drum synth skeptics say never actually existed. Using a DX7 emulator of our own design, we forged each facet of the CRYPTID, reconstructing its wretched inner-workings. From the \"Log Drum\" Toms to the \"Wood Block\" Cowbell. Blow that Samba Whistle and hit the Gong! Do you want to believe? The project is using Rust and the Faust to Rust backend, and the source code is available .","title":"OneTrick CRYPTID"},{"location":"community/powered-by-faust/#bespoke-anywhere","text":"This paper reports on the Audio Anywhere project, a framework for working with audio plugins that are compiled once and run anywhere. At the heart of Audio Anywhere is an audio engine whose Digital Signal Processing components are written in Faust and deployed with WebAssembly, by Benedict Gaster and Ryan Challinor, presented at Nime 2021 .","title":"Bespoke Anywhere"},{"location":"community/powered-by-faust/#a-technical-framework-for-musical-biofeedback-in-stroke-rehabilitation","text":"We here present work a generalized low-level technical framework aimed to provide musical biofeedback in post-stroke balance and gait rehabilitation, built by an iterative user-centered process. The framework comprises wireless wearable inertial sensors and a software interface developed using inexpensive and open-source tools. The interface enables layered and adjustable music synthesis, real-time control over biofeedback parameters in several training modes, and extensive supplementary functionality. JUCE and FAUST are used to create a versatile architecture for layered, yet computationally efficient real-time music synthesis.","title":"A Technical Framework for Musical Biofeedback in Stroke Rehabilitation"},{"location":"community/powered-by-faust/#forcehost","text":"ForceHost: an open-source toolchain for generating firmware embedding the authoring and rendering of audio and force-feedback haptics, by Christian Frisson, Mathias Kirkegaard, Thomas Pietrzak, and Marcelo M. Wanderley presented at Nime 2022 . The Faust compiler has been modified to support haptics.","title":"ForceHost"},{"location":"community/powered-by-faust/#sentinelle","text":"Sentinelle is a sound and robotic art installation made by J\u00e9r\u00f4me Abel . A robot-probe is placed in a dark place, a cellar. It scans its surroundings with two lasers. The reliefs of the old walls, their imperfections, mold, appear thanks to the perfectly straight lines of the lasers. Its movements are synchronized with a sound program. From these very simple visual and sound choreographies are born an imaginary on its functioning and the origin of its presence. The spectator observes in a mirror a robot which observes and testifies. Does it communicate with other systems? Does it send information? Its energy is precious, like a heartbeat or a breath, it works in a segmented way with periods of silence. Likewise, his movements are slow and relentless. Faust objects from https://github.com/grame-cncm/faust/tree/master-dev/examples included with pd-faustgen : examples/gameaudio/bubble examples/delayEcho/echo examples/gameaudio/rain examples/generator/sawtoothLab","title":"Sentinelle"},{"location":"community/powered-by-faust/#langfaust-and-uifaust","text":"CEAMMC PureData distribution 2023.02. General purpose Pd distribution and library used for work and education purposes in Centre of electroacoustic music of Moscow Conservatory ( CEAMMC ) and ZIL-electro studio. This repository is an assembly of Puredata that includes the CEAMMC library. It includes the lang.faust~ and ui.faust~ externals and a lot of Faust DSP .","title":"lang.faust~ and ui.faust~"},{"location":"community/powered-by-faust/#arco4-sound-synthesis-engine-and-framework","text":"Arco is a sound synthesis engine that offers dynamic patching of of unit generators. It is designed to operate as a small embedded server, running either in its own process or within an application. In the spirit of \"smaller is better,\" Arco DSP is mainly delegated to FAUST , leveraging a wide range of existing algorithms. Arco control is delegated to external languages connecting through O2, which supports running Arco within the same application, in a separate process or even on a remote networked host. Arco should be a nice alternative to libpd as an embedded sound engine. The author is mainly using Arco in tandem with Serpent, a real-time Python-like scripting language, but other language bindings are possible.","title":"arco4 - sound synthesis engine and framework"},{"location":"community/powered-by-faust/#synthesizer-synthesizer","text":"This is a dual-course project for CS378 NLP and CS393P. The goal is to use language model guided program synthesis to synthesize Faust DSP code to ... automatically program synthesizers. Not guaranteed to work. In the slightest.","title":"Synthesizer-synthesizer"},{"location":"community/powered-by-faust/#ambisonics-in-kmh-studios-and-lilla-salen","text":"The general idea behind using ambisonics for diffusing sounds in a space is to, in the first stage, encode an audio signal to a representation of a sound field - a B-format signal. This B-format signal is independent of whatever speaker array the signal will later be diffused on. In the second stage the B-format signal is decoded to the layout of a particular speaker array. In between these two stages a number of transformations may be applied, but the sound source specification may conveniently be specified in the encoder. The decoders are written in Faust.","title":"Ambisonics in KMH studios and Lilla salen"},{"location":"community/powered-by-faust/#sardine","text":"Sardine is a free/open-source software for Python 3.10+. It turns Python into a musical instrument. You can play it alone or with your friends. With Sardine you can: Play synthesizers and audio samples using SuperCollider. Control synthesizers through MIDI/OSC messages. Interconnect audio/video softwares and/or sound engines. Play collaboratively with your friends. Extend your musical environment using any Python package. Faust written DSP can be used in Sardine.","title":"Sardine"},{"location":"community/powered-by-faust/#kandiskyscore","text":"KandiskyScore is a graphical editor for the analysis and creation of electroacoustic/acousmatic music. It is an html/javascript application. It works perfectly with Firefox, Chrome and Opera and therefore on all Windows, OSX, Linux and other PCs. It uses the WebAudio API for sound generation and the Faust language of the GRAME for plugins. It also allows you to export a graphic score in SVG format that you can eventually modify with a vector graphics software like Inkscape or LibreOffice-draw.","title":"KandiskyScore"},{"location":"community/powered-by-faust/#fildesoi1_2_3","text":"Software (including Faust code , Max and PureData patches) to perform Fil de Soi 1 and Fil de Soi 2, mixed music pieces by Alain Bonardi for acoustic guitar and electronics.","title":"fildesoi1_2_3"},{"location":"community/powered-by-faust/#enecho","text":"Faust code for En Echo piece by Manoury for soprano and live electronics.","title":"enecho"},{"location":"community/powered-by-faust/#zen-flute","text":"The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board .","title":"Zen Flute"},{"location":"community/powered-by-faust/#souffle","text":"An electro track made with Faust . You can listen to a recording here .","title":"souffle"},{"location":"community/powered-by-faust/#ghg-gruppenhorchgerat","text":"The project is a demonstration of a technique called delay-sum beamforming with the aim to replicate the sound heard by operators of passive sonar devices used in the second world war. Listen to the video here . The simulation code is written in Faust.","title":"GHG (Gruppenhorchger\u00e4t)"},{"location":"community/powered-by-faust/#satuverb","text":"Satuverb is a flexible reverb that has many creative and natural sounding uses, produced by request for FBPM. It has a saturator and EQ controls inside the reverberator, which apply every time the signal is fed back. This causes the effects to grow more extreme as the reverb tail trails off. Satuverb's reverberator is based on Jon Dattorro's 1997 design and written in Faust .","title":"Satuverb"},{"location":"community/powered-by-faust/#faustilogue","text":"Convert Faust DSP files to KORG logue custom oscillators, using the logue SDK .","title":"faustilogue"},{"location":"community/powered-by-faust/#blippoo-for-wingie","text":"Blippoo for Wingie is an alternative firmware for Wingie2. The new firmware is inspired by Blippoo Box, a genius instrument created by Rob Hordijk (1958-2022), who contributed a lot to synthesizer design. May his spirit lives on in his instrument designs, thoughts, and influences. The new firmware could turn your Wingie2 into a self-contained instrument capable of producing a variety of sounds and patterns. As a great companion, it will help you in your music-making practice especially when you want to applicate controlled chaos in your music. The DSP is written in Faust .","title":"Blippoo for Wingie"},{"location":"community/powered-by-faust/#6171_reverb","text":"A vintage reverb based on designs from 1961 and 1971, written in Faust .","title":"6171_reverb"},{"location":"community/powered-by-faust/#teensy-wfs","text":"Distributed Wave Field Synthesis (WFS) implementation for networked Teensies. There is a WFS Controller JUCE app in wfs-controller. This uses JACK's C API to set up ports and connect to any Teensy JackTrip clients. It notifies the clients of their positions in the WFS array, plus the positions of virtual sound sources, via OSC over UDP multicast. The WFS algorithm is written in Faust .","title":"teensy-wfs"},{"location":"community/powered-by-faust/#pd-remote","text":"This is a simplified and unified version of the Pd remote control helpers that I've been distributing with various Pd externals such as pd-faust and pd-lua over the years. The present implementation will work with any of these and replaces the more specialized versions. It takes the form of a Pd abstraction pd-remote.pd and an accompanying pd-remote.el elisp file for Emacs.","title":"pd-remote"},{"location":"community/powered-by-faust/#crossroad2effects","text":"Crossroad2Effects, the functional successor to @jatinchowdhury's CrossroadsEffects , is a genetic algorithm infrastructure for filter exploration. Provided with dry and wet sound file, Crossroad2Effect determines the filter that tampered the dry file and presents it as a Faust program. This allows users to have granular access to analog or VST filters through a programming interface. This project constructs its genetic algorithm search on top of pedalboard, Spotify's new plugin API.","title":"Crossroad2Effects"},{"location":"community/powered-by-faust/#flatten","text":"What is an envelope flattener ? It's similar to an automatic gain control, compressor, or maximizer in that it acts by modifying the gain of the signal according to a control signal. Like these, the control signal is derived from the envelope of the input signal. The DSP is written in Faust .","title":"flatten"},{"location":"community/powered-by-faust/#drumvoice","text":"Drumvoice is a percussion instrument LV2 plugin. Drumvoice can also make lots of other percussion sounds, like kick drums, toms, single hand claps, and all kinds of smaps and blinks. The DSP is written in Faust .","title":"drumvoice"},{"location":"community/powered-by-faust/#verber","text":"Verber is a simple audio plugin tool with a Sweet, Lushy reverb processor. It is a portolio project built in JUCE and HISE, with the DSP in Faust .","title":"Verber"},{"location":"community/powered-by-faust/#reach","text":"Extraterrestrial Reverb for Electronic Music. REACH is modern creative Reverb that is made for synthetic sound sources. There are four effects included to transform the Signal. It features modular routing, pre and post filters and over 40 Presets. Part of the DSP code is written in Faust .","title":"REACH"},{"location":"community/powered-by-faust/#stray_virtual-synth","text":"A typical wavetable synthesizer will have a table of predetermined amplitude values which are read through at the appropriate speed relative to the frequency of the current note, resulting in an audible signal. Stray functions similarly, reading through a table of values, but the amplitude values are not predefined. Instead, these values are modulated with one of four LFO shapes. The DSP code is written in Faust.","title":"Stray_virtual-synth"},{"location":"community/powered-by-faust/#drty-drums","text":"A 4 voices drum machine based on FM synthesis [WIP]. The sound engine is made in Faust .","title":"Drty Drums"},{"location":"community/powered-by-faust/#201-musical-synthesizer","text":"We\u2019re Critter & Guitari and we\u2019re happy to announce our newest synthesizer: the 201! If you\u2019re familiar with our other musical instruments such as the Pocket Piano, Organelle, Bolsa Bass, or Kaleidoloop, we hope you\u2019ll see that the 201 fits right in with them: the 201 is fun, portable, and packed with a medley of musical magic! Inside, the 201 uses a combination of Pure Data and Faust musical programming environments. Users are invited to modify or create new sound engines!","title":"201 Musical Synthesizer"},{"location":"community/powered-by-faust/#onetrick-simian","text":"Crash into the 80s with an open source drum synth inspired by hexagonal classics like the Simmons SDS-V . Thumping kicks , punchy snares , and sizzling cymbals coalesce with its clacky claves and crunchy claps . Bring saccharine synthwave sauce to your sublime soundscapes or drop indelable pewww pewww tom toms into your new nu-disco . Get the source code containing Faust DSP , using the Dlang backend.","title":"OneTrick SIMIAN"},{"location":"community/powered-by-faust/#collisiondrivelv2","text":"CollisionDrive is modeled after the Horizon Devices Precision Drive, a modern overdrive pedal with a built-in noise gate, with DSP written in Faust .","title":"CollisionDrive.lv2"},{"location":"community/powered-by-faust/#metaltonelv2","text":"Distortion Pedal simulation. MetalTone is modeled after the renowned BOSS MT-2 Metal Zone, a high gain distortion pedal with an advanced EQ section, with DSP written in Faust .","title":"MetalTone.lv2"},{"location":"community/powered-by-faust/#tamgamplv2","text":"Tamgamp (Rhymes with: \"Damage Amp\") is a LV2 guitar amp simulator that provides two plugins, with DSP code developed with Faust : Tamgamp - a plugin based on Guitarix DK Builder simulated chains. TamgampGX - a plugin based on tuned Guitarix internal amplifiers implementation.","title":"tamgamp.lv2"},{"location":"community/powered-by-faust/#reverbzen","text":"A Reverb written with Faust and JUCE, based on SchroederReverberators . This reverb effect uses different stages. It splits input signal in parallel and uses different types of delaylines. Different filters are provided to get rid of unwanted resonances. Check out reverb.dsp file to get more detailed insight.","title":"ReverbZen"},{"location":"community/powered-by-faust/#wingie2","text":"Wingie2 is a handheld stereo resonator that you can use as a development platform, and can be programmed with Faust .","title":"Wingie2"},{"location":"community/powered-by-faust/#slowmolv2","text":"A multiband slow gate with delay/echo. The C++ files for the effect are generated from Faust DSP files: Bandsplit.cc , Delay.cc and Volume.cc .","title":"Slowmo.lv2"},{"location":"community/powered-by-faust/#vocoder-app","text":"Vocoder mobile app for Android made with Faust and its Smartkeyboard interface. This app was developed in the context of a project for the the Real Time Interaction and Performance exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2020). The paper A Faust-built Mobile Vocoder Instrument, included in the repo, provides more information on the algorithm, as well as the description of a case prototype.","title":"Vocoder App"},{"location":"community/powered-by-faust/#echoplex-ep-3-simulator","text":"This archive contains a virtual model of the Echoplex Ep-3 tape delay. The effect has been developed using Faust in the context of a project for the Sound Processing exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2019). The paper Faust Model of the Echoplex Tape Delay, included in the repo, provides more information on the algorithm.","title":"Echoplex Ep-3 Simulator"},{"location":"community/powered-by-faust/#faust2smartphone","text":"faust2smartphone is a tool to generate interactive musical mobile application embedded Faust API.","title":"faust2smartphone"},{"location":"community/powered-by-faust/#dpf-fadeli","text":"An experiment with Faust Demo Library content as DPF plugins. Basically glueing a few different projects together, to compile Faust DSP programs in several plugins format: LADSPA, LV2, VST2, VST3, CLAP : DPF faust faustpp faust examples","title":"DPF-Fadeli"},{"location":"community/powered-by-faust/#tr8ck","text":"TR8CK is an experimental DAW/tracker with Faust live coding via faust2webaudio and UI powered by SolidJS .","title":"TR8CK"},{"location":"community/powered-by-faust/#guitard","text":"It's a basic multi effects processor which follows a node based approach. Components are developed with Faust .","title":"GuitarD"},{"location":"community/powered-by-faust/#hise","text":"HISE is an open source framework for building sample based virtual instruments combining a highly performant Disk-Streaming Engine, a flexible DSP-Audio Module system and a handy Interface Designer. The implementation of the Faust integration was the result of a Google Summer of Code project done by Roman Sommer with the help of Christoph Hart as mentor.","title":"HISE"},{"location":"community/powered-by-faust/#mbstereophony","text":"This is a simple implementation of a Regalia-Mitra filter bank using 3rd order Cauer low-pass filters as the base designs. There are four filter bank programs available which are described below. MBStereophony itself is a demo effect that down-mixes a stereo signal separately per frequency band.","title":"MBStereophony"},{"location":"community/powered-by-faust/#audiolab","text":"A docker based DSP learning/Experimentation environment including: Jupyter lab FAUST python 3.7 (at the moment. Depends on miniconda3 docker image) FAUSTpy to run FAUST code inside jupyter faustWidgets (to interactively control FAUST code ) librosa (for MIR and feature extraction) scipy, pandas, numpy for general data science sox (encoding, batch processing etc) ffmpeg (encoding batch processing etc) seaborn (more beautiful plots) latex TODO (for exporting jupyter notebooks)","title":"Audiolab"},{"location":"community/powered-by-faust/#lr_delay","text":"A stereo delay plugin which emphasizes free (non beat-synced) controls for the individual channels. Built with Faust and JUCE.","title":"LR_Delay"},{"location":"community/powered-by-faust/#leslie-speaker-simulator","text":"This archive presents a virtual simulation of the Leslie Speaker commonly found in Hammond electric organs. The digital effect has been developed using the FAUST programming language, and then ported into a VST-compatible format using the JUCE C++ framework.","title":"Leslie speaker simulator"},{"location":"community/powered-by-faust/#cookiecutter-dpf-faust","text":"A cookiecutter project template for DISTRHO Plugin Framework ( DPF ) audio effect plugins using FAUST for the implementation of the DSP pipeline. Look at the demo video .","title":"cookiecutter-dpf-faust"},{"location":"community/powered-by-faust/#df-zita-rev1","text":"A feedback-delay-network reverb plugin built with DPF and based on a FAUST library demo. Several other projects are developed using the same DPF/FAUST methothodolgy: FAUST filters , a collection of virtual-analog filters from the FAUST standard library packaged as multi-format plugins via the DPF SendMixer , a stereo channel strip plugin with one master gain and two pre/post-fader sends Stereo Cross Delay , a stereo delay plugin with feedback and cross-mixing.","title":"DF Zita Rev1"},{"location":"community/powered-by-faust/#theremotion","text":"Theremotion is a virtual instrument inspired by the Theremin. Just like a Theremin, the position of your hand in the air controls the pitch and volume of the sound. However, you can also control much more dimensions of the sound with specific motions. With specific hand positions, you can control a low pass filter, a supersaw sound, a guitar sound and more. You can even make the instrument \"stick\" to a scale, making it much easier to control than a Theremin. The hand tracking is provided by Ultraleap's Leap Motion Controller . The sound generation is created with Grame's Faust . The program is built with Rust .","title":"Theremotion"},{"location":"community/powered-by-faust/#hypercurve","text":"Hypercurve is a library allowing you to combine several curve algorithms into a single 2D envelope. It is designed to be used in audio applications, for people who know how to enjoy a finely shaped curve. As shown above, you can perfectly combine gaussian curve with diocles cissoid curve, and plenty of other curve algorithms. The library can be used in C++, Lua, Csound and Faust .","title":"Hypercurve"},{"location":"community/powered-by-faust/#faust-mcp","text":"This package provides a Pd abstraction mcp.pd (along with some helper abstractions and externals) which lets you control your Faust instruments and effects more conveniently with control surfaces utilizing the Mackie Control Protocol (MCP).","title":"faust-mcp"},{"location":"community/powered-by-faust/#faustquark","text":"This SuperCollider package makes it possible to create SuperCollider packages (Quarks) containing plugins written in Faust code. With this, you can distribute plugins written in Faust and make it easy for others to install, compile or uninstall them. It also contains some simple interfaces for the faust and faust2sc.py commands used behind the scenes.","title":"Faust.quark"},{"location":"community/powered-by-faust/#komet","text":"Komet is a computer music / sound system by Mads Kjeldgaard written in SuperCollider and Faust . Komet is a computer music system that makes advanced synthesis operations and composition easier. It auto generates thousands of synthesizer variations from simple recipes and offers a range of DAW-like features such as effect chains (like on channel strips) and other conveniences. It can work natively in stereo, multichannel or high order ambisonics mode with the flick of a switch, allowing the same compositions to be used in different sound systems.","title":"Komet"},{"location":"community/powered-by-faust/#faug","text":"A Minimoog Model D emulation with the DSP portion written in Faust and using JUCE framework. Moog + Faust = Faug.","title":"Faug"},{"location":"community/powered-by-faust/#striso-studio","text":"A virtual Web version of the Striso board, using the Faust WebAssembly compiled sythesizer code .","title":"Striso Studio"},{"location":"community/powered-by-faust/#sttera","text":"A Software for Audio Recognition and Orchestration as Medium for Music Ritual. Faust WebAssembly library is used internally with the faust2webaudio project.","title":"Sttera"},{"location":"community/powered-by-faust/#xuidesigner","text":"A WYSIWYG LV2 X11UI GUI creator tool. Provide a easy to use GUI generator tool to create X11 UI's for LV2 plugins. Currently only libxputty is supported, but the generated GUI C file could be used probably with other widget tool-kits as well, just a wrapper file is needed to translate the generated file to the needs of a toolkit. XUiDesigner could now parse faust (.dsp) files and generate a full LV2 Bundle for them. A faust (.dsp) file could be given by the command-line parameter -f or simply by drag it on the Designer window. It will create all control widgets which you could then rework to your needs before you save your Bundle.","title":"XUiDesigner"},{"location":"community/powered-by-faust/#dsp-speech-processor","text":"A Faust based DSP Speech Processor. Based on the Daz DSP v2.1 Speech Processor firmware, with improvements. Compiled into Webassembly format. Runs in a web browser!","title":"DSP Speech Processor"},{"location":"community/powered-by-faust/#squaring-loop-synchronous-am-isb-demodulator","text":"This demodulator uses a squaring loop to regenerate the AM carrier from the sidebands during signal fades. This allows it to maintain carrier lock even without a carrier! The squaring loop multiplies the signal with itself, causing a 2F carrier to be generated. Carrier + carrier = 2F. LSB + USB = 2F.","title":"Squaring Loop Synchronous AM ISB Demodulator"},{"location":"community/powered-by-faust/#eurorack-blocks","text":"The eurorack-blocks project allows to develop your own custom Eurorack module for either prototyping or fun in the comfort of your day-to-day IDE with the C++ or Faust language , or using the Cycling '74 Max environment, testing and debugging in a virtual Eurorack environment, and when ready, to auto-magically generate all the needed files to manufacture the eurorack module for you to use in a real Eurorack modular system.","title":"eurorack-blocks"},{"location":"community/powered-by-faust/#amstramgrame","text":"An arts and sciences educational project (STEAM), bringing together services and resources for the educational community. It aims at making abstract scientific concepts more tangible and concrete through musical creation and computer programming. The Gramophone is an audio device/musical instrument specifically designed for the AmStramGrame project. Its various sensors and controllers (e.g., accelerometer, gyroscope, light sensor, etc.) make it react to the user's gestures. Its rechargeable battery offering approximately five hours of autonomy and its powerful speaker make it independent from any computer, bringing it closer to traditional acoustic musical instruments. DSP programs are coded in Faust . Additional examples can be found in GramoCollection .","title":"AmStramGrame"},{"location":"community/powered-by-faust/#gamelan","text":"GameLAN is a set of musical applications designed by Grame , National Center of Musical Creation. They are based on Faust technology and have been designed to be played using only the movements of the smartphone. No musical prerequisite, only your gestures will make you a musician!","title":"GameLAN"},{"location":"community/powered-by-faust/#screamer","text":"Version 1.0 is the accurate Faust reproduction of a VST plug-in written in 2003. In later versions, the parameter ranges is modified and some new functionality are added. This signal mangler features a weird kind of overdrive (see source code for exact formula), a hard-clip distortion, LFO-modulated bit reduction and the possibility of calculating the modulo of a signal.","title":"Screamer"},{"location":"community/powered-by-faust/#typebeat","text":"Typebeat is a virtual groovebox that\u2019s entirely keyboard-operated. Typebeat draws inspiration from two computing environments. Effects are developped in Faust then generated as Rust modules .","title":"Typebeat"},{"location":"community/powered-by-faust/#afdn-reverb","text":"(High-Order) Ambisonics Feedback Delay Network Reverb. Code is developed in Faust and Max.","title":"AFDN-reverb"},{"location":"community/powered-by-faust/#karpsichord","text":"A virtual harpsichord based on Karplus-Strong string synthesis, implemented in Faust and running in the Web .","title":"Karpsichord"},{"location":"community/powered-by-faust/#arduino-audio-tools","text":"Some basic header-only C++ classes that can be used for Audio Processing provided as Arduino Library. A simple Interface class to use Faust with Arduino Audio Tools is provided . Code can be written using Faust .","title":"Arduino Audio Tools"},{"location":"community/powered-by-faust/#organelle","text":"The Organelle makes it easy to explore new sounds and experiment with new ways of making music. It combines playful and intuitive controls with a powerful and flexible sound engine. The result is an instrument that is limitless in musical possibility and a joy to play. At the heart of the Organelle's sound engine is a robust computer that runs patches. A patch allows the instrument to take on different forms. Onboard hardware for sound input and output and mappable knobs, keys and buttons enable patches to synthesize, sample, effect, and anything in between! The Organelle can be programed with Faust as explained here and with this PD external using Faust .","title":"Organelle"},{"location":"community/powered-by-faust/#zrythm","text":"Zrythm is a digital audio workstation designed to be featureful and easy to use. It offers streamlined editing workflows with flexible tools, limitless automation capabilities, powerful mixing features, chord assistance and support for various plugin and file formats. A set of Faust effects are compiled as LV2 plugins and included in the application.","title":"Zrythm"},{"location":"community/powered-by-faust/#patches-for-the-owl-pedaleurorack-module","text":"This is a collection of patches written or ported specifically for the OWL. Most of them were written using FAUST and if you want to modify them you'll need to have a working FAUST installation. C++ source code (the .hpp files) for the OWL can be generated by running the \"updateFaustPatches.py\" python script. Then you will need to rebuild the OWL firmware and upload it to the device.","title":"Patches for the OWL Pedal/Eurorack Module"},{"location":"community/powered-by-faust/#kiwi","text":"Kiwi is a graphical programming environment dedicated to music and sound creation, such as Max or Pure Data softwares, but offering a real-time collaborative approach: Kiwi allows several distant users to work simultaneously on the same patch hosted online. Kiwi is part of the French ANR-funded MUSICOLL project that unites the CICM and OhmForce. The main goal of this project is to study how collaboration can enhance the way digital audio music composition is taught and more generally how it can renew music creation practices and improve its workflow. Faust DSP programs can be dynamically compiled as objects included in the patch. An extended presentation of the system can be found in this IFC 2020 paper .","title":"Kiwi"},{"location":"community/powered-by-faust/#brainwave-virtual-instrument","text":"The Brainwave Virtual Instrument (BVI) is an open-source software synthesizer built in the programming language Faust. Its purpose is to facilitate the exploration of electroencephalogram (EEG) and other brain data through sonification. Pre-recorded data is translated as parameter controls of the instrument in the form of Open Source Control (OSC) messages that are generated and streamed by a small python program. The instrument can easily be distributed and compiled to different targets thanks to Faust\u2019s flexibility. Frequency Modulation synthesis provides a comprehensive approach to textural parameters of sounds, so that musical composition and improvisation based on a creative use of brain data become feasible. This is exemplified by the Brainwave Etudes (BE), a series of compositions inspired by measurements of brain activity during different states of mind. The BVI was created for two major purposes: on the one hand, to find musical structures that relate to each other in order to present an aesthetic proposal, and on the other, to create a tool that familiarizes scientists and researchers in the field of neuroscience with sonification techniques, and the exploration of brain activity through sound. An extended presentation of the system can be found in this IFC 2020 paper .","title":"Brainwave Virtual Instrument"},{"location":"community/powered-by-faust/#mephisto","text":"Mephisto is a transpiler for converting sound patches designed using the graphical computer music environment Pure Data to the functional DSP programming language Faust. Faust itself compiles into highly-optimized C++ code. The aim of the transpiler is to enable creating highly optimized C++ code embeddable in games or other interactive media for sound designers, musicians and sound engineers.","title":"Mephisto"},{"location":"community/powered-by-faust/#weather_organ","text":"Weather Organ is a Faust instrument for manipulating sparse noise to imitate slowly-changing natural sound sources such as rain, wind, surf, fire, Geiger counters and volcanic activity, and to create interesting new textures of sound. It is the product of various discoveries made while using Faust to explore the definition, synthesis and experience of acoustic noise while, simultaneously using the exploration of noise as as focus for learning Faust.","title":"weather_organ"},{"location":"community/powered-by-faust/#genius-eurorack-module","text":"The Genius is the next evolutionary step for the OWL platform, and the first product released based on a Cortex M7 microcontroller. It runs the OWL firmware and so can be programmed with Faust. A demo running bells from thee physical library can be listened to here .","title":"Genius Eurorack Module"},{"location":"community/powered-by-faust/#dataflow-based-fpga-program-synthesis","text":"A Yale-NUS BSc. (Hons) in Mathematical, Computational, and Statistical Sciences Capstone: an FPGA Program Generator written in Python that takes dsp-sig XML Dataflow Graphs created using FAUST to produce FPGA programs in VHDL.","title":"Dataflow Based FPGA Program Synthesis"},{"location":"community/powered-by-faust/#dspedal","text":"DSPedal is a custom hardware platform for real-time sound effects. It is operated by few knobs, external expression pedal, couple of buttons and a small graphical LCD. Processing effect is written in Faust programming language and compiled into C code. So far the Cortex M4 core clocked at 204 MHz has proven to be capable of executing relatively complex effects like wah, but effect-chaining quickly reaches the limits of processing power.","title":"DSPedal"},{"location":"community/powered-by-faust/#tambura","text":"Waveguide physical model of an Indian Tambura/Tanpura. This is a FAUST patch inspired by the Indian Tambura/Tanpura - a four string drone instrument, known for its unique rich harmonic timbre. The model uses a few tricks to produce a Tambura-like sound, and should probably be referred to as a \"pseudo\" physical model, because it does not attempt to accurately recreate the physics of the string-bridge interaction. It includes a range of parameters selected to allow control of the qualities of the excitation/pluck, string behavior and sympathetic resonance. It can produce some beautiful evolving drones, which can vary from very synthetic to quite natural. The model can be tested here .","title":"Tambura"},{"location":"community/powered-by-faust/#drumbox","text":"drumbox is a fun and powerful drum synthesizer for your Android device. Start from a preset and tweak the sounds and appearance to make it your own. Freestyle on the drum pads, record a sequence or both...it's up to you!","title":"drumbox"},{"location":"community/powered-by-faust/#granola","text":"Granola is a monophonic granular live feed processor. The grain processor is inspired by the Mutable Instruments Beads. The grain window shape control is inspired by the GR-1 Granular synthesizer from Tasty Chips Electronics. The DSP code is written in Faust.","title":"Granola"},{"location":"community/powered-by-faust/#fverb","text":"A stereo variant of the reverberator by Jon Dattorro coded in Faust.","title":"fverb"},{"location":"community/powered-by-faust/#sonification","text":"This study has been developed as a proof-of-concept for data pattern sonification. We've implemented data pattern sonification using FM synthesis coded in Faust. Air pollution data, which is temporal, is retrieved from the server and is done pattern mining. Then pattern data sonification is done.","title":"Sonification"},{"location":"community/powered-by-faust/#gula-plugins","text":"A collection of guitar effect LV2 plugins ( The Vibey , The Splits , The Fades , SSaP Tone , Sweabed , Pequed , Peak audio to CV , LFO CV ) with MOD Devices user interfaces.","title":"GULA Plugins"},{"location":"community/powered-by-faust/#limiterstereo","text":"Yet another look-ahead limiter code in Faust. The novel aspect of this limiter is that it uses N cascaded one-pole filters for amplitude profiling, which improves smoothness in the first to N-1 order derivatives and reduces total harmonic distortion. This design uses four cascaded one-pole lowpass filters, following the cut-off correction formula (8.9) found in [Zavalishin 2012].","title":"limiterStereo"},{"location":"community/powered-by-faust/#web-audio-modules","text":"Web Audio Modules are an open source framework facilitating the development of high-performance Web Audio plugins (instruments, realtime audio effects and MIDI processors). They can be developed using JavaScript and Web standards or compiled from C, C++ code, and domain-specific languages such as Faust or Csound. The Faust Web IDE contains an integrated GUI builder, read a tutorial here .","title":"Web Audio Modules"},{"location":"community/powered-by-faust/#kapitonov-plugins-pack","text":"Set of 7 plugins for guitar sound processing, compiled in LADSPA and LV2 formats. Compatible with hosts such as Ardour, Qtractor, Carla, guitarix, jack-rack. The DSP of all of them is written in Faust.","title":"Kapitonov Plugins Pack"},{"location":"community/powered-by-faust/#tubeamp-designer","text":"Standalone software guitar processor, editor of *.tapf profile files for tubeAmp (KPP) and guitar amp profiler.","title":"tubeAmp Designer"},{"location":"community/powered-by-faust/#biosignals","text":"BioSignals is a data aquisition and processing device for EMG, ECG and EEG signals. Since it is using the OpenWare firmware, it can be programmed with Faust.","title":"BioSignals"},{"location":"community/powered-by-faust/#scale-it","text":"Scale it is an open source program (written in graphical programming language Pure data and in Faust) that allows sonification of a signal distribution in real time. There are two different possibilities of sonification of the signal. One of the objects, tone, generates changes in pitch of a monophonic tone. The other object, chord, expresses the input value in width of polyphony. Scale it is being developed primarily for neurofeedback purposes. To allow straightforward and customizable instruments to carry sonic feedback about EEG activity in specific regions of the neocortex.","title":"Scale it"},{"location":"community/powered-by-faust/#jacktrip","text":"JackTrip is a Linux, macOS, or Windows multi-machine audio system used for network music performance over the Internet. It supports any number of channels (as many as the computer/network can handle) of bidirectional, high quality, uncompressed audio signal streaming. Several DSP effects ( compressor , freeverb , zitarev , limiter ) are written in Faust, compiled as C++ code, and included in project sources .","title":"JackTrip"},{"location":"community/powered-by-faust/#level-rider","text":"This is an audio plugin written in Faust that automates gain level adjustments, based on a target gain level, a time window over which overall loudness is calculated via RMS, and a maximum adjustment threshold. This plugin is comparable to Waves Vocal Rider or Waves Bass Rider in its functionality, but is free and open-source.","title":"Level Rider"},{"location":"community/powered-by-faust/#whetstone-transient-shaper","text":"A free, open source transient shaping audio plugin that operates on a specified frequency band. Whetstone will extract a certain frequency band based on a low cutoff and high cutoff that you choose, apply transient shaping to it, and then reintegrate the shaped band back into the original signal. This plugin is meant to be comparable to the excellent Spiff plugin in its core functionality, but lacks many of the nice features and polished UI. The DSP is coded in Faust .","title":"Whetstone Transient Shaper"},{"location":"community/powered-by-faust/#reverb-trickery","text":"A free, open source audio plugin implementing various creative reverb effects, including octave-shifted, distorted, hi-pass/low-passed, gated, and narrowing reverb, coded in Faust .","title":"Reverb Trickery"},{"location":"community/powered-by-faust/#b259wf","text":"This is a model of the \"tibre\" circuit of the Buchla 259 Complex Wave Generator, made in Faust . The model follows the circuit modelling as seen on the paper Virtual Analog Buchkla 259 wavefolder , using 5 folds. The proposed 2-point BLAMP antialiasing method has been attempted for arbitrary sources as shown here , but it is not sufficient for high frequencies and/or more complex signals. Instead, filtering and light cubic nonlinearity distiorion has been used to round corners and for clipping. The user interface consists of the controls fold for the folding amount, offset for offseting the signal before folding, and lowpass as a final stage one-pole filtering to control the character (too much folding might introduce unwanted higher harmonics for certain signals). The final output is dc-blocked.","title":"b259wf"},{"location":"community/powered-by-faust/#string-machine","text":"This is a virtual-analog string ensemble synthesizer. The implementation is based on a digital model designed by Peter Whiting. The improvement of the model adds various abilities, in particular a virtual-analog emulation of the bucket brigade delay circuit. Most of the DSP code is developed using Faust. Three VST or LV2 are generated: string-machine , string-machine-chorus and string-machine-chorus-stereo .","title":"string-machine"},{"location":"community/powered-by-faust/#metafx","text":"The metaFx is a control surface for continuous sound transformations in real time, just like the metaSurface64. Like metaSurface64 , it has both its own loop generator and a multi-effects FX engine, but its operation is different, especially for the management of plugin chains and pads. Each mixer on this surface can directly control the gain and the attached plug-ins. It is also possible to control the tracks of an external sequencer (Ardour or Reaper). To do this, the application uses OSC controllable modules that come from the Faust language library that is embedded in the application. Its interest lies in the construction of a parallel sound processing chain in the form of a graph.","title":"metaFx"},{"location":"community/powered-by-faust/#kymaticacom","text":"Jonatan Liljedahl at Kymatica AB makes iOS music apps, electronic music, and a little bit of audio hardware. The following iOS applications have DSP code developed using Faust: AU3FX:Push : AUv3 dynamics processor with noise gate, compressor/expander with external side-chain input, brick-wall look-ahead limiter and hard/soft clipper. AU3FX:Space : High quality tweakable AUv3 reverb with resonant filters. For everything between small rooms, resonators, and infinitely large spaces. AU3FX:Dub : Stereo AUv3 delay effect for everything from clean digital delays to filthy dub echoes, ping-pong flangers, and broken cassette tapes. AUFX:PeakQ : A versatile 4-band parametric stereo equalizer for everything between subtle frequency enhancements and agressive boosting/cutting or special resonator effects.","title":"Kymatica.com"},{"location":"community/powered-by-faust/#nemesis","text":"Nemesis is multichannel dsp platform for eurorack. It can be programmed with Faust .","title":"Nemesis"},{"location":"community/powered-by-faust/#sonobus","text":"SonoBus is an easy to use application for streaming high-quality, low-latency peer-to-peer audio between devices over the internet or a local network. Several DSP effects ( Compressor , Expander , Limiter , ParametricEQ , Reverb ) have been written in Faust , compiled as C++ code, and included in the JUCE project .","title":"Sonobus"},{"location":"community/powered-by-faust/#xplugslv2","text":"This repository contain the LV2 plugins developed using libxputty/XUidesigner. The included makfile allows the build of all plugins against a single checkout of libxputty. Each plugin exists as its own submodule under this repository. Some of the DSP code has been written with Faust.","title":"XPlugs.lv2"},{"location":"community/powered-by-faust/#bass-preamp-drive","text":"The goal of this project is to digitally reproduce the behavior of a well-known electric bass preamp: Ampeg SVT3 Pro. This preamp has been copied by several manufacturers. So we have an almost perfect copy with the Bugera BVP5500 which has four preamplifier tubes. An analog copy is also available as a pedal, the Tech 21 BDDI. The project is based on advances in the simulation of analog circuits made available by the Guitarix project and the excellent Faust from Grame cncm.","title":"Bass Preamp Drive"},{"location":"community/powered-by-faust/#drum-module","text":"This project aims at integrating a digital drum synthesizer using Faust and Miosix real time OS on an STM32F407VG Discovery Board. To do this, a user interface by means of buttons, sliders, encoders, and an LCD has been implemented to control the synthesizer. Moreover, a serial MIDI input port has been added in order to control the synthesizer externally by using an external sequencer or controller.","title":"Drum Module"},{"location":"community/powered-by-faust/#daisy-based-audio-boards","text":"Daisy is an embedded platform for music. It features everything you need for creating high fidelity audio hardware devices. Just plug in a USB cable and start making sound! No soldering required. It can be programed with Faust using the faust2daisy tool.","title":"Daisy based audio boards"},{"location":"community/powered-by-faust/#elk-audio-os","text":"Elk is an Audio Operating System developed from the ground up to deliver real time audio performances in embedded systems and remote networks. It can run on several hardware . Faust can be used to generate VST2 plugins to run on the plaform.","title":"Elk Audio OS"},{"location":"community/powered-by-faust/#er-301-sound-computer","text":"The ER-301 is a voltage-controllable canvas for digital signal processing algorithms. It can be programed with Faust using the faust2er301 tool and some units are developed here . Note that it is still a WIP, read the discussion here .","title":"ER-301 Sound Computer"},{"location":"community/powered-by-faust/#zynthian-platform","text":"Zynthian is a new class of musical device. A powerful multitimbral synthesizer and audio processor, capable of managing up to 16 audio chains simultaneously. Also, it's a MIDI processor and router, equipped with standard MIDI ports, USB, WIFI & wired networks. Zynthian is a community-driven project and it's 100% open source. The Zynthian platform can be programmed with Faust with some DSP examples here .","title":"Zynthian platform"},{"location":"community/powered-by-faust/#gxpluginslv2","text":"GxPlugins.lv2 is a set of more than 40 extra standalone lv2 plugins designed to compliment the Guitarix project. Each plugin exists as its own submodule under this repository. The DSP code has been written with Faust.","title":"GxPlugins.lv2"},{"location":"community/powered-by-faust/#stone-phaser","text":"A classic analog phaser effect. This is an analog phaser with similarity to the Small Stone. It has a color switch, which makes the phasing stronger when on, and adds some feedback controls. A stereo variant of the phaser is included. This effect is supported on MOD devices. The DSP code is developed in Faust .","title":"Stone phaser"},{"location":"community/powered-by-faust/#sfizz","text":"sfizz is a sample-based musical synthesizer. It features the well-established SFZ instrument format at its core, which permits to use existing instrument libraries, or create personal instruments with ease. Not only is sfizz ready-to-use as an instrument plugin of its own, the library allows developers to create instruments of their own, taking advantage of the abilities of SFZ. The sfizz project uses the SFZ parser and synth c++ library, providing AU / LV2 / VST3 plugins and JACK standalone client. Some effects are developed in Faust are well as several filters .","title":"sfizz"},{"location":"community/powered-by-faust/#antescofo","text":"Antescofo is a coupling of a real-time listening machine with a reactive and timed synchronous language developed at IRCAM . The language is used for authoring of music pieces involving live musicians and computer processes, and the real-time system assures its correct performance and synchronization despite listening or performance errors. Antescofo audio DSP processes can be described with Faust , using libfaust dynamic version of the Faust compiler.","title":"Antescofo"},{"location":"community/powered-by-faust/#motion-vox","text":"A mobile music creation and performance workstation with a built-in motion-based controller, sequencer and synthesis engine. The controller unites XY pad, accelerometer and gyroscope events with complex data \ufb01ltering engine. Performance process consists of touching the active area on the screen with the index finger and moving the cursor while moving the device in space. Smartphone position in space and finger movement on a screen affect various parameters of sound or generate realtime MIDI output. The app was inspired by the SmartFaust project of GRAME. The audio engine of the app is made with FAUST.","title":"Motion Vox"},{"location":"community/powered-by-faust/#inscore","text":"INScore is an open source framework for the design of interactive, augmented, live music scores. Augmented music scores are graphic spaces providing representation, composition and manipulation of heterogeneous and arbitrary music objects (music scores but also images, text, signals...), both in the graphic and time domains. Audio DSP processes and effects can be described using Faust. The environment runs as a native application but also in the Web. Faust programs are only supported by the online version .","title":"INScore"},{"location":"community/powered-by-faust/#virtual-rhizome","text":"By Vincent Carinola . Virtual Rhizome responds to a proposal by Christophe Lebreton and Jean Geoffroy to compose a work for the original Smart Hand Computer system, developed at the GRAME-CNCM using the Faust language and allowing to play smartphones as an instrument. The work takes the form of a labyrinth, a kind of virtual architecture that could be compared to Borges' \"garden of branching paths\", within which the musician evolves by adapting his gestures to the constraints of different types of situations. Each situation is characterized by an autonomous functioning of the system, that the musician must apprehend in order to find the key allowing him to modify it and to move towards another situation. But in order to orientate himself well, he must create a mental representation of the structure of the work. The performer then becomes an explorer of a world that he unveils, but isn't that what he has always been? Virtual rhizome owes much to the availability and enthusiasm of Jean Geoffroy and Christophe Lebreton. It is amicably dedicated to them.","title":"Virtual Rhizome"},{"location":"community/powered-by-faust/#smartfaust","text":"SmartFaust is a concept of musical applications for smartphones. These applications have the particularity of only using the user's gestures and not by tapping on the device's screen. Made for iOS and Android, they can also use the motion sensors of these devices to make them real musical instruments. Smartfaust applications are based on the Faust (Functional Audio Stream) programming language developed by Grame over the last 15 years and recognized as a standard in the field of real-time signal processing for audio. The SmartFaust applications were first used for the creation of the pieces Mephisto (for drums and cell phone ensemble), Belzebuth (participative piece for public equipped with Smartphones), Iblis (for clarinet and cell phone ensemble) and B\u00e9lial (for harp and cell phone ensemble) written by the composer Xavier Garcia. From this same technology were later created the applications \"Geek Bagatelles\" (2016) and \"GameLan\" (2019). Download here: Android & iOS","title":"SmartFaust"},{"location":"community/powered-by-faust/#trombone-simulator","text":"This simulator is a physical model of a trombone. Physical models of the lips, mouthpiece, slide, and bell are digitally simulated. The controls are listed at the top. The main controls are to move the cursor (or your finger on a touch device) left and right on the picture to adjust the embouchure, and up and down to extend and retract the slide. The diagonal colored lines are a guide to where the resonances are: playing over a resonance means that the embouchure and slide length are matched. Playing over white space means that one is between resonances and the note quality won't be as good. The big gray wedge on the upper right indicates that the resonances are very close together there. The vertical dashed lines indicate the rough locations of B-flat (thick lines) and F (thin lines). Other notes are unmarked, and likewise the slide positions. (Just like on a real trombone!) The off-key resonances (7th, 11th, 13th, and 14th) are marked in red. The g and f keys can be used to growl and flutter-tongue, respectively. The audio simulation is written in Faust, which conveniently compiles to WebAssembly and a Web Audio API wrapper. The overall approach used was a digital waveguide model, as described in J. O. Smith III's Digital Waveguide Theory. The lips and bell are adapted from F. Scott's masters thesis.","title":"Trombone Simulator"},{"location":"community/powered-by-faust/#integrating-1-dof-force-feedback-interactions-in-self-contained-dmis","text":"By Mathias Kirkegaard . This thesis presents a system for designers of Digital Musical Instruments (DMIs) to explore the integration of 1 degree of freedom (DoF) force feedback interactions in new self-contained instruments. The system developed consists of an open-source graphical tool and a rotary force-feedback device made from commercially available components to facilitate the authoring of audio-haptic applications. Implementing an early prototype is used to inform the development of the graphical editing tool and its integration in an embedded audio-haptic environment using the functional programming language Faust for real-time signal processing.","title":"Integrating 1-DoF force feedback interactions in self-contained DMIs"},{"location":"community/powered-by-faust/#beyond-key-velocity-continuous-sensing-for-expressive-control-on-the-hammond-organ-and-digital-keyboards","text":"By Giulio Moro . In this thesis we seek to explore the potential for continuous key position to be used as an expressive control in keyboard musical instruments, and how pre- existing skills can be adapted to leverage this additional control. The nonlinear waveguide physical model of a flute has been developed in Faust.","title":"Beyond Key Velocity: Continuous Sensing for Expressive Control on the Hammond Organ and Digital Keyboards"},{"location":"community/powered-by-faust/#guide-de-la-synthese-sonore","text":"By Sebastien Clara . In this guide, I try to demystify how sound synthesis works. To do so, I present the fundamental principles of sound synthesis. I accompany these explanations with small sound applications that you can manipulate in your web browser and thus, you will be able to notice the impact of a parameter on the sound. Most of the sound examples are written in Faust and run in the web pages. This guide is currently only in french.","title":"Guide de la synth\u00e8se sonore"},{"location":"community/powered-by-faust/#pico-dsp","text":"PICO DSP is an open-source, Arduino-compatible ESP32 development board for audio and digital signal processing (DSP) applications. It offers an expansive audio-processing feature set on a small-format, breadboard-friendly device that provides audio inputs, audio outputs, a low-noise microphone array, an integrated test-speaker option, additional memory, battery-charge management, and ESD protection all on one tiny PCB. The board can be programmed using Faust .","title":"PICO DSP"},{"location":"community/powered-by-faust/#soundjack","text":"The Soundjack realtime communication application is extended by a server cloud to handle up to 60 musicians of an orchestra, developed with the Faust programming language. Each musician is connected to a Soundjack UDP client. An individual stereo mix of the multiple audio streams originating from the multiple Soundjack clients has to be provided to each listening musician. An extended presentation of the system can be found in this IFC 2018 paper .","title":"Soundjack"},{"location":"community/powered-by-faust/#studiox-switcher","text":"Studiox-switcher is an input switcher and silence detector for JACK. It can switch between 3 stereo inputs, a fallback channel is activated if the active input is below a volume threshold for some amount of seconds, and channels may be switched via OSC and HTTP. The core DSP engine is done via Faust for switching, silence detection and level metering.","title":"studiox-switcher"},{"location":"community/powered-by-faust/#synthspace","text":"Synthspace is the ultimate virtual synthesizer. It combines the familiarity of real instruments with the possibilities of virtual worlds. Nodes for Synthspace can be developed in Faust .","title":"SynthSpace"},{"location":"community/powered-by-faust/#bass21","text":"This VST3 is a virtual-analog simulation of the famous Bass Driver DI Version 1 preamp pedal from Tech21. The discretization, while far from being exact, is moderately close to the original. The potentiometers are identical to these physically present on the BDDI pedal, apart from the pregain which is specific to this digital version. The DSP code is written in Faust.","title":"Bass21"},{"location":"community/powered-by-faust/#echomatrix","text":"The EchoMatrix was designed to provide some of the functionality of the Yamaha UD Stomp pedal as used be Alan Holdsworth. This project will be submitted to the KVR Developer Challenge 2021 contest to highlight the power of the Faust DSP development environment and the JUCE framework to create a non-trivial effect VST3 using a managable amount of Faust DSP code .","title":"EchoMatrix"},{"location":"community/powered-by-faust/#the-striso-board","text":"The Striso board is a very expressive music instrument which combines multidimensionally sensitive keys with an innovative note layout that helps understand the structures in music. The keys capture each subtle finger movement, which allows for levels of musical expression previously only known to acoustic instruments. Additionally, accents and sound effects can be added by shaking and moving the instrument as a whole. The internal sound is written in Faust, and is controlled directly by the signals from the keys and motion sensor. External synthesizers can be controlled using MPE MIDI, or using OSC which is easier to set up for Faust synthesizers. The firmware source code is released as open source.","title":"The Striso board"},{"location":"community/powered-by-faust/#live-concatenative-granular-processing","text":"This algorithm addresses signal discontinuity and concatenation artefacts in real-time granular processing with rectangular windowing. By combining zero-crossing synchronicity, first-order derivative analysis, and Lagrange polynomials, we can generate streams of uncorrelated and non-overlapping sonic fragments with minimal low-order derivatives discontinuities. The resulting open-source algorithm, implemented in the Faust language, provides a versatile real-time software for dynamical looping, wavetable oscillation, and granulation with reduced artefacts due to rectangular windowing and no artefacts from overlap-add-to-one techniques commonly deployed in granular processing.","title":"Live concatenative granular processing"},{"location":"community/powered-by-faust/#fb_suppression","text":"ALS - Automatic Larsen Suppression algorithms implementing adaptive filtering through spectral centroid calculation, and adaptive frequency shifting through RMS calculation.","title":"fb_suppression"},{"location":"community/powered-by-faust/#ossia-score","text":"Ossia score is a sequencer for audio-visual artists, designed to enable the creation of interactive shows, museum installations, intermedia digital artworks, interactive music and more in an intuitive user interface. Faust can be used to create advanced audio processes . A demo video of the Faust integration can be seen here .","title":"ossia score"},{"location":"community/powered-by-faust/#faselunare-microcosmos","text":"Microcosmos is a small open-source electronic board, developed by \u200bFaselunare (Italy), aimed at prototyping electronic musical instruments and learning electronics, microcontroller programming and audio DSP, and programmable with Faust. A demo video of the project can be seen here . The project has been presented at ADC21 .","title":"FASELUNARE Microcosmos"},{"location":"community/powered-by-faust/#audio-anywhere","text":"The goal of Audio Anywhere is to explore the idea of compile once, run anywhere for audio DSP code. Audio Anywhere combines Faust, for audio DSP code, and HTML5 to enable development of modern audio synthesis and effects tools. There are currently three main repos for this work: AA examples AA standalone app AA Wasmtime runtime","title":"Audio Anywhere"},{"location":"community/powered-by-faust/#the-keywi","text":"An Expressive and Accessible Electronic Wind Instrument, where the sound is synthesized with Faust running on the Bela Mini processing board.","title":"The KeyWi"},{"location":"community/powered-by-faust/#react-web-audio-guitar-studio","text":"React Web Audio Guitar Studio is an online real-time Web Audio based all-in-one guitar studio, using native plugins written on Faust, compiled on-demand, and ran in a browser.","title":"React Web Audio Guitar Studio"},{"location":"community/powered-by-faust/#jspatcher","text":"JSPatcher is a Visual Programming Language (VPL) in Max/PureData style on the web with following features: Patch WebAudio native AudioNodes Play with JavaScript Web APIs Import and patch external JavaScript modules Customize AudioWorklet DSPs with Faust A presentation video can be seen here .","title":"JSPatcher"},{"location":"community/powered-by-faust/#gwion","text":"Gwion is a programming language aimed at making music. It is strongly inspired by ChucK and can use a set of plugins for Gwion . One allows to use the libfaust library to JIT compile and run DSP code on the fly. The faust2gw tool allows to produce statically compiled modules.","title":"Gwion"},{"location":"community/powered-by-faust/#sonejostudios","text":"A set of tools written using Faust.","title":"sonejostudios"},{"location":"community/powered-by-faust/#panoramix","text":"Stereo Panorama/Balance and Volume Automation Tool.","title":"Panoramix"},{"location":"community/powered-by-faust/#mixer4x","text":"A simple 4-channel stereo mixer. The main goal is to use it as a submixer on a 4 channel track, but you can use it everywhere you need a small 4 channel stereo mixer.","title":"Mixer4x"},{"location":"community/powered-by-faust/#faustdrumseq","text":"A very simple drum sequencer written with Faust, using the new soundfile object.","title":"faustdrumseq"},{"location":"community/powered-by-faust/#midiclockclick","text":"A simple metronom driven by MidiClock.","title":"MidiClockClick"},{"location":"community/powered-by-faust/#superbeatrepeater","text":"Beat Repeater with Sidechain Beat Recognation and Midi-Clock Sync. Very useful i.e to add musical diversity by looping short parts of the stream (i.e drums).","title":"SuperBeatRepeater"},{"location":"community/powered-by-faust/#supercutsequencer","text":"Cut \"On/Off\" Sequencer (8 steps with smooth) synced to Midi-Clock Beats and Midi-Clock Start/Stop. Very useful i.e to add musical diversity in looped tracks (very nice with i.e bass lines).","title":"SuperCutSequencer"},{"location":"community/powered-by-faust/#delooper","text":"Sample-accurate Looper/Delay with free mode and midi-clock sync mode.","title":"DeLooper"},{"location":"community/powered-by-faust/#xymatrix","text":"XY Surround Matrix for one Source (Mono Input) with 4 Outputs (Left, Right, Surround Left, Surround Right) and Position Lock.","title":"XYMatrix"},{"location":"community/powered-by-faust/#stm32-faust-synth","text":"STM32 synthesizer video is a short presentation of a polyphonic synthesizer based on STM32F405 \u00b5C. Faust is used for signal processing and a TLV320AIC23B stereo codec serves as DAC. Another more recent video is here .","title":"stm32-faust-synth"},{"location":"community/powered-by-faust/#faustgen2","text":"The faustgen2~ object is a Faust external for Pd a.k.a. Pure Data , Miller Puckette's interactive multimedia programming environment.","title":"faustgen2~"},{"location":"community/powered-by-faust/#amati","text":"Amati is a VST plugin for live-coding effects in the Faust programming language. As of now it only provides basic functionality.","title":"Amati"},{"location":"community/powered-by-faust/#puretones","text":"PureTones PureTones is a family of software tools for Indian Classical music. They are built based on an in-depth study and exploration of Indian Classical music to understand the role of harmonics, microtones and consonance in Indian Ragas and musical scales: PureTones Drone (using first tab) , is a digital Tanpura with controls for fine tuning the strings and adjusting their harmonic envelope. PureTones Musical Scale (using second tab) is a digital 12 note keyboard with controls for fine tuning each key to be consonant with an accompanying drone track. PureTones Sequencer (using third tab) is a sequencer which enables composition of melodies and musical works in Indian Classical music using notes from a fine tuned musical scale. The Ragatronics project combines Ragas from Indian Classical music with elements from Rock, Jazz and Electronic music. All applications have been developed using Faust and WebAudio tools.","title":"PureTones"},{"location":"community/powered-by-faust/#making-sound-machines","text":"Making Sound Machines are a duo of makers from D\u00fcsseldorf, Germany. We build kits, modules and DIY projects, and use the projects we\u2019ve built to make music. Faust is used in several projects.","title":"Making Sound Machines"},{"location":"community/powered-by-faust/#master_me","text":"Automatic audio mastering plugin for live-streaming, podcasting and internet radio stations. With the first Covid-19 related lock-downs in 2020, many real-life concerts, conferences and festivals were forced into the digital domain - and sounded pretty crappy. Having worked for almost 20 years in audio mastering, Berlin based engineer Klaus Scheuermann started to develop master_me - a word fusion of automatic mastering and mini-me - in order to make open source streaming sound better. After a few weeks of learning and development, master_me was first used at the 'Quarantine Sessions' - a weekly distributed electro-acoustic improvised concert, hosted at Stanford's CCRMA Institute. master_me was developed further to be an easy-to-use tool for all live streaming applications. In 2022 it was funded by the Prototype Fund, an open source software funding initiative by the german ministry of education and research. A stable release is available since September 2022.","title":"master_me"},{"location":"community/powered-by-faust/#metasurface64","text":"metaSurface64 is a real-time continuous sound transformation control surface that features both its own loop generator for up to 64 voices and a multi-effects FX engine. The application embeds the libfaust dynamic version of the Faust compiler.","title":"metaSurface64"},{"location":"community/powered-by-faust/#fragment-audio-server-and-fragment","text":"Fragment Audio Server (FAS) is a high performance pixels-based graphical audio synthesizer implemented as a WebSocket server with the C language (C11). Faust , is embedded (when compiled with WITH_FAUST ) and allow to dynamically extend FAS bank generators and effects with custom one written with the Faust DSP specification language. FAS is the audio engine used in Fragment , the Collaborative Graphical Audio Synthesizer. Follow the demo here .","title":"Fragment Audio Server and Fragment"},{"location":"community/powered-by-faust/#swanky-amp","text":"Swanky Amp is a tube amplifier simulation DSP plugin which aims to capture the details in the dynamics of tube amplifiers. The DSP is primarily written in Faust , whereas the UI is written in C++ using the JUCE . Follow the demo here . A commercial version is available here .","title":"Swanky Amp"},{"location":"community/powered-by-faust/#web-synth","text":"This is a web-based DAW (Digital Audio Workstation) written in Rust/WebAssembly and TypeScript with extensive Faust language integration with dynamic remote code compilation and executing via WebAssembly. Follow the demo here .","title":"Web Synth"},{"location":"community/powered-by-faust/#dawdreamer","text":"DawDreamer is an audio-processing Python framework supporting core DAW features such as audio playback, VST MIDI instruments, VST effects, Faust , and parameter automation. DawDreamer is written with JUCE , with a user-friendly Python interface thanks to pybind11 . DawDreamer draws from an earlier VSTi audio \"renderer\", RenderMan .","title":"DawDreamer"},{"location":"community/powered-by-faust/#td-faust","text":"TD-Faust enables Faust code to run inside TouchDesigner . Follow the demo here .","title":"TD-Faust"},{"location":"community/powered-by-faust/#mephisto-lv2","text":"Mephisto LV2 a Just-in-Time Faust compiler embedded in an LV2 plugin. Write LV2 audio/cv instruments/filters directly in your host in Faust DSP language without any need to restart/reload host or plugin upon code changes.","title":"Mephisto LV2"},{"location":"community/powered-by-faust/#iplug2","text":"iPlug 2 is a simple-to-use C++ framework for developing cross platform audio plug-ins/apps and targeting multiple plug-in APIs with the same minimalistic code, support for the Faust programming language, and the libfaust JIT compiler.","title":"iPlug2"},{"location":"community/powered-by-faust/#pmix","text":"pMix (short for preset mixer) is a sound design, composition and performance tool that facilitates the control of multiple parameters using an intuitive graphical interface. It includes a graphical patcher for creating a network of audio synthesis or processing nodes. A node could be a VST2, VST3, AU or LADSPA plug-in or it could a JIT compiled FAUST script. FAUST is a first class citizen in pMix and an integrated code editor and SVG display makes it a nice environment for FAUST development.","title":"pMix"},{"location":"community/powered-by-faust/#temper-juce-plugin","text":"Temper is a digital distortion audio plugin targeting VST, VST3, and AU for OS X and Windows. It builds upon traditional waveshaping techniques using modulated filter coefficients to produce a unique phase distortion. The primary signal processing loop is written with Faust, and compiled with JUCE for the various build targets.","title":"Temper JUCE plugin"},{"location":"community/powered-by-faust/#faust-mass-interaction","text":"mi_faust implements 1D mass-interaction models in the FAUST programming language. Starting from a scripted model description (see MIMS), mi_faust compiles a physical model into FAUST code. It handles this by generating routing functions between all the masses and all the interactions in the model. Head over to the FAUST community page to see examples of a series of instruments created in mi_faust, and available as web-apps !","title":"Faust Mass-Interaction"},{"location":"community/powered-by-faust/#dynamic-pedalboard","text":"Dynamic PedalBoard allows users to plug different stompboxes together in a web browser.","title":"Dynamic PedalBoard"},{"location":"community/powered-by-faust/#sharc-dsp-board","text":"The ADI SHARC DSP board fully supports Faust.","title":"SHARC DSP Board"},{"location":"community/powered-by-faust/#nuance","text":"Nuance is a pressure sensitive music controller that uses Faust for sound synthesis and processing.","title":"Nuance"},{"location":"community/powered-by-faust/#the-plateaxe","text":"The PlateAxe is a percussion instrument physical model controller using Faust for sound synthesis and processing.","title":"The PlateAxe"},{"location":"community/powered-by-faust/#the-bladeaxe","text":"The BladeAxe is an electric guitar physical model controller using Faust for sound synthesis and processing.","title":"The BladeAxe"},{"location":"community/powered-by-faust/#bart-brouns-projects","text":"A collection of projects by Bart Brouns and based on Faust.","title":"Bart Brouns' Projects"},{"location":"community/powered-by-faust/#eartone-toolbox","text":"The Ear Tone Toolbox is a collection of unit generators for the production of auditory distortion product synthesis.","title":"EarTone Toolbox"},{"location":"community/powered-by-faust/#audiokit","text":"AudioKit allows developers to quickly add professional audio functionality to iOS, macOS, and Apple Watch apps.","title":"AudioKit"},{"location":"community/powered-by-faust/#radium","text":"Radium is a music editor with a new type of interface. It includes a Faust audio DSP development environment. Compared to the normal sequencer interface editing is quicker and more musical data fits on the screen. Compared to trackers, note positions and effects are edited graphically, which should be quicker, provide more vertical space and give a better musically overview. (Everything can also be edited by text, like in a normal tracker) Radium can also be used as a normal multitracker to mix and record audio.","title":"Radium"},{"location":"community/powered-by-faust/#bela","text":"Bela is a maker platform for creating beautifully responsive audio and interactive applications. Designed for artists, musicians, researchers and makers, Bela brings the power of ultra-low latency interactive audio and sensors to your digital projects. It can be programmed with Faust .","title":"BELA"},{"location":"community/powered-by-faust/#hoa-library","text":"HOA Library allows musicians and composers to synthesize, transform and render sound fields in a creative and artistic way. This library facilitates the understanding and the appropriation of key concepts of ambisonics. Thanks to original graphical interfaces a lot of new signal processings are allowed like diffuse sound field synthesis, perspective distorsion or spatial filtering. HOA library is open-source and free and offers a set of C++ and FAUST classes and implementation for Max, PureData and Unity.","title":"HOA Library"},{"location":"community/powered-by-faust/#ambitools","text":"Ambitools is a collection of plug-ins and tools for 3D sound field synthesis using Higher Order Ambisonics (HOA). The plugins are written in the Faust language , which allows them to be compiled for a multitude of architectures and platforms (Windows, Mac, Linux, WebAudio, embedded systems, etc.) Moreover, the code is written in a scalable way: there is no limit to the maximum Ambisonic order! Other tools are also available, such as a 3D Visualizer written in the Processing language.","title":"Ambitools"},{"location":"community/powered-by-faust/#ambisonic-decoder-toolbox","text":"The Ambisonic Decoder Toolbox is a collection of MATLAB and GNU Octave functions for creating Ambisonic Decoders. Currently, it implements: (1) the AllRAD design technique, (2) inversion or mode-matching, (3) truncated mode-matching, constant energy, (4) linear combinations of 2 and 3, and (5) Slepian function basis (EPAD). The DSP code is written in MATLAB and Faust.","title":"Ambisonic Decoder Toolbox"},{"location":"community/powered-by-faust/#ambisonicxyz","text":"A set of tools around Ambisonics.","title":"Ambisonic.xyz"},{"location":"community/powered-by-faust/#faustpy","text":"FaustPy is a Python wrapper for Faust. It is implemented using the CFFI and hence creates the wrapper dynamically at run-time.","title":"FaustPy"},{"location":"community/powered-by-faust/#rebel-technology","text":"The OWL Pedal is an open source, programmable stage effects pedal, made for guitarists, musicians, hackers and programmers. Users can program their own effects, or download ready-made patches from our growing online patch library.","title":"Rebel Technology"},{"location":"community/powered-by-faust/#faust-vst","text":"This project provides a VST plugin architecture for the Faust programming language. The package contains the Faust architecture, faustvst.cpp, the faust2faustvst helper script which provides a quick way to compile a plugin, a collection of sample plugins written in Faust, and a generic GNU Makefile for compiling and installing the plugins.","title":"faust-vst"},{"location":"community/powered-by-faust/#faust-lv2","text":"This project provides an LV2 plugin architecture for the Faust programming language. The package contains the Faust architecture and templates for the needed LV2 manifest (ttl) files, a collection of sample plugins written in Faust, and a generic GNU Makefile as well as a shell script to compile plugins using the architecture.","title":"faust-lv2"},{"location":"community/powered-by-faust/#rdk","text":"Reverb Design is about creating a spacial impression aimed at sweetening the listening experience for a given context. The ambiguity of auditory and visual cues in reproduced sound makes it necessary to create an auditory illusion: To make this illusion work, I propose an aesthetic concept of simplicity and intelligibility based on psychoacoustic facts and recording practice as professional producer.","title":"RDK"},{"location":"community/powered-by-faust/#foo-yc20","text":"The Foo YC20 is an open source implementation of the Yamaha YC-20 combo organ from 1969. Processing for the organ is based on original schematics and measurements from a working specimen. This instrument simulates the circutry as a whole to realisticly reproduce the features and flaws of the real deal.","title":"Foo YC20"},{"location":"community/powered-by-faust/#fauck","text":"FaucK is a Chugin allowing to combine the powerful, succinct Functional AUdio STream (Faust) language with the strongly-timed ChucK audio programming language. FaucK allows programmers to on-the-fly evaluate Faust code directly from ChucK code and control Faust signal processors using ChucK's sample-precise timing and concurrency mechanisms. The goal is to create an amalgam that plays to the strengths of each language, giving rise to new possibilities for rapid prototyping, interaction design and controller mapping, pedagogy, and new ways of working with both Faust and ChucK.","title":"FaucK"},{"location":"community/powered-by-faust/#snd-rt","text":"Snd-RT is the realtime extension for the sound editor SND and consists of two parts: the RT Engine - An engine for doing realtime signal processing. the RT Compiler - A compiler for a scheme-like programming language to generate realtime-safe code understood by the RT Engine.","title":"Snd-RT"},{"location":"community/powered-by-faust/#pure-language","text":"[Pure is a modern-style functional programming language based on term rewriting. It offers equational definitions with pattern matching, full symbolic rewriting capabilities, dynamic typing, eager and lazy evaluation, lexical closures, built-in list and matrix support and an easy-to-use C interface. The interpreter uses LLVM as a backend to JIT-compile Pure programs to fast native code. It has been created by Albert Gr\u00e4f. pd-faust is a collection of Pd objects written using pd-pure which lets you run Faust programs inside Pd. It combines the functionality of pure-faust and faust2pd in a single package, and also features dynamic reloading of Faust plugins, automatic generation of controller GUIs and MIDI/OSC controller mappings, as well as OSC-based controller automation. It thus provides a complete solution for interactively developing Faust dsps in Pd.","title":"Pure Language"},{"location":"community/powered-by-faust/#guitarix","text":"An audio plug-in for guitar effects whose sound processing engine is written in Faust.","title":"Guitarix"},{"location":"community/powered-by-faust/#moforte-geoshred","text":"An electric guitar app using physical modeling. Faust was used to implement its sound synthesis/processing engine.","title":"moForte GeoShred"},{"location":"community/powered-by-faust/#moforte-powerstomp","text":"An app implementing various guitar effects to be used on stage.","title":"moForte PowerStomp"},{"location":"community/powered-by-faust/#moforte-guitar","text":"An app that can be used as an electric guitar and whose sound synthesis engine is implemented in Faust.","title":"moForte Guitar"},{"location":"community/powered-by-faust/#faustworks","text":"FaustWorks is an IDE (Integrated Development Environment) for the Faust dsp programming language. You must have Faust installed to be able to use FaustWorks. Platforms supported are Linux and OSX.","title":"FaustWorks"},{"location":"community/powered-by-faust/#faustlive","text":"FaustLive is an advanced self-contained prototyping environment for the Faust programming language with an ultra-short edit-compile-run cycle. Thanks to its fully embedded compilation chain, FaustLive is simple to install and doesn't require any external compiler, development toolchain or SDK to run. FaustLive is the ideal tool for fast prototyping. Faust programs can be compiled and run on the fly by simple drag and drop. They can even be edited and recompiled while running, without sound interruption. It supports also native applications generation using the Faust online compiler. FaustLive is based on the Faust library and on LLVM. \u200b","title":"FaustLive"},{"location":"community/press/","text":"Faust in the Press 2018 CDM, Vadim is a master of the dark arts of DSP \u2013 listen to him explain filters , October 19, 2018. France Musique, Bernard Cavanna, compositeur agit\u00e9 ! - Albums \"\u00c0 l\u2019agit\u00e9 du bocal\" & \"Le caillou dans la chaussure\" , October 10, 2018. BNEWS, \u0426\u0438\u0444\u0440\u043e\u0432\u0430\u044f \u043e\u0441\u0435\u043d\u044c \u0432 \u0410\u043b\u043c\u0430\u0442\u044b: \u041c\u043e\u043b\u043e\u0434\u044b\u0435 \u043c\u0443\u0437\u044b\u043a\u0430\u043d\u0442\u044b \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u043b\u0438 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u0433\u0430\u0434\u0436\u0435\u0442\u043e\u0432 , October 18, 2018. iProfesional, Una orquesta sinf\u00f3nica dara un concierto en Buenos Aires junto a un coro de \"smartphones\" , October 06, 2018. SWR Aktuell Rheinland-Pfalz, Programmiersprache macht digitale T\u00f6ne , July 17, 2018. Deutschlandfunk, F\u00fcr einen Mathematiker ist das der Himmel , July 21, 2018. Deutschlandfunk, Radio-Premiere f\u00fcr die Zarenglocke , July 21, 2018. Piekary, Ch\u00f3r\u2026smarfon\u00f3w w Filharmonii \u015al\u0105skiej , May 10, 2018. Tribune de Gen\u00e8ve, Quand smartphones et orchestre s\u2019accordent , March 22, 2018. MDR Th\u00fcringen, Jenaer Philharmonie spielt Smartphone-Konzert , February 26, 2018. iDNES.cz, VIDEO: Filharmonici p\u0159izvali na p\u00f3dium studenty, zahr\u00e1li na sv\u00e9 mobily , February 16, 2018. 2017 Le Dauphin\u00e9 Lib\u00e9r\u00e9, https://www.ledauphine.com/isere-nord/2017/10/28/rejoignez-l-orchestre-de-smartphones , October 28, 2017. Wired.it, Geek Bagatelles, il concerto per orchestra e smartphone , October 18, 2017. Tecnologia, Geek Bagatelles. Al Romaeuropa Festival il concerto per orchestra e coro di smartphone , October 12, 2017. Capital avec Management, Musique et Entreprise : la M\u00e9thode Gagnante de la Soci\u00e9t\u00e9 G\u00e9n\u00e9rale , April 17, 2017. France Info, Fl\u00fbte pr\u00e9historique et ch\u0153ur de smartphones, l\u2019Orchestre de Picardie innove , February 07, 2017. France Info, La smartophonie : quand le portable devient instrument de musique , January 24, 2017. 2016 France Info, SmartFaust, l'application qui transforme les portables en instruments , December, 6, 2016. Le Parisien, \"SmartFaust\", des applis pour jouer de la musique avec son portable , March 26, 2016.","title":"Press"},{"location":"community/press/#faust-in-the-press","text":"","title":"Faust in the Press"},{"location":"community/press/#2018","text":"CDM, Vadim is a master of the dark arts of DSP \u2013 listen to him explain filters , October 19, 2018. France Musique, Bernard Cavanna, compositeur agit\u00e9 ! - Albums \"\u00c0 l\u2019agit\u00e9 du bocal\" & \"Le caillou dans la chaussure\" , October 10, 2018. BNEWS, \u0426\u0438\u0444\u0440\u043e\u0432\u0430\u044f \u043e\u0441\u0435\u043d\u044c \u0432 \u0410\u043b\u043c\u0430\u0442\u044b: \u041c\u043e\u043b\u043e\u0434\u044b\u0435 \u043c\u0443\u0437\u044b\u043a\u0430\u043d\u0442\u044b \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u043b\u0438 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u0433\u0430\u0434\u0436\u0435\u0442\u043e\u0432 , October 18, 2018. iProfesional, Una orquesta sinf\u00f3nica dara un concierto en Buenos Aires junto a un coro de \"smartphones\" , October 06, 2018. SWR Aktuell Rheinland-Pfalz, Programmiersprache macht digitale T\u00f6ne , July 17, 2018. Deutschlandfunk, F\u00fcr einen Mathematiker ist das der Himmel , July 21, 2018. Deutschlandfunk, Radio-Premiere f\u00fcr die Zarenglocke , July 21, 2018. Piekary, Ch\u00f3r\u2026smarfon\u00f3w w Filharmonii \u015al\u0105skiej , May 10, 2018. Tribune de Gen\u00e8ve, Quand smartphones et orchestre s\u2019accordent , March 22, 2018. MDR Th\u00fcringen, Jenaer Philharmonie spielt Smartphone-Konzert , February 26, 2018. iDNES.cz, VIDEO: Filharmonici p\u0159izvali na p\u00f3dium studenty, zahr\u00e1li na sv\u00e9 mobily , February 16, 2018.","title":"2018"},{"location":"community/press/#2017","text":"Le Dauphin\u00e9 Lib\u00e9r\u00e9, https://www.ledauphine.com/isere-nord/2017/10/28/rejoignez-l-orchestre-de-smartphones , October 28, 2017. Wired.it, Geek Bagatelles, il concerto per orchestra e smartphone , October 18, 2017. Tecnologia, Geek Bagatelles. Al Romaeuropa Festival il concerto per orchestra e coro di smartphone , October 12, 2017. Capital avec Management, Musique et Entreprise : la M\u00e9thode Gagnante de la Soci\u00e9t\u00e9 G\u00e9n\u00e9rale , April 17, 2017. France Info, Fl\u00fbte pr\u00e9historique et ch\u0153ur de smartphones, l\u2019Orchestre de Picardie innove , February 07, 2017. France Info, La smartophonie : quand le portable devient instrument de musique , January 24, 2017.","title":"2017"},{"location":"community/press/#2016","text":"France Info, SmartFaust, l'application qui transforme les portables en instruments , December, 6, 2016. Le Parisien, \"SmartFaust\", des applis pour jouer de la musique avec son portable , March 26, 2016.","title":"2016"},{"location":"community/publications/","text":"Academic Publications Around Faust This page presents a non-exhaustive list of publications around the Faust programming language. If you think one of your papers is missing, let us know and we'll add it! menuholder","title":"Academic Publications"},{"location":"community/publications/#academic-publications-around-faust","text":"This page presents a non-exhaustive list of publications around the Faust programming language. If you think one of your papers is missing, let us know and we'll add it!","title":"Academic Publications Around Faust"},{"location":"community/publications/#menuholder","text":"","title":"menuholder"},{"location":"community/sponsors/","text":"Faust Sponsors","title":"Sponsors"},{"location":"community/sponsors/#faust-sponsors","text":"","title":"Faust Sponsors"}]}
\ No newline at end of file
+{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"What is Faust? Faust (Functional Audio Stream) is a functional programming language for sound synthesis and audio processing with a strong focus on the design of synthesizers, musical instruments, audio effects, etc. created at the GRAME-CNCM Research Department . Faust targets high-performance signal processing applications and audio plug-ins for a variety of platforms and standards. The core component of Faust is its compiler. It allows to \"translate\" any Faust digital signal processing (DSP) specification to a wide range of non-domain specific languages such as C++, C, LLVM bit code, WebAssembly, Rust, etc. In this regard, Faust can be seen as an alternative to C++ but is much simpler and intuitive to learn. Thanks to a wrapping system called \"architectures,\" codes generated by Faust can be easily compiled into a wide variety of objects ranging from audio plug-ins to standalone applications or smartphone and web apps, etc. The Faust Web IDE Getting Started If You're in a Hurry If you\u2019re in a hurry and just wanna have a look at how Faust programs look like, you can simply check the Faust Examples . If You Wanna Get Started With Faust If you\u2019re looking for a step by step tutorial of approximately 2 hours that will walk you through writing simple Faust programs and give you an overview of what Faust can do, have a look at our Quick Start Tutorial . If You\u2019re Looking for the \"Manual\" Faust\u2019s syntax and features are thoroughly documented in the Faust Manual . This resource contains hundreds of code examples and many short tutorials. If You\u2019re Looking for the Documentation of a Function in the Faust Libraries The documentation of Faust's standard libraries is automatically generated directly from the libraries' source code. If You prefer Video Tutorials Check out the Faust Kadenze course . If You want to discover Projects Powered by Faust Check out the Powered by Faust page. If You're looking for Papers on Faust Check out Faust papers and reports on HAL . Faust News >> February 21, 2024: GRAME has been selected as a Google Summer of Code 2024 mentor organization Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the third consecutive year, GRAME has been selected as a mentor organization for the Faust project. >> December 02, 2023: Programmable Audio Workshop (PAW-23) The 6th edition of Programmable Audio Workshop (PAW) will be held on December 2rd at the Marie Curie Library of INSA Lyon (France) on the La Doua campus and is organised by the Emeraude INRIA/INSA/GRAME-CNCM team. This year's theme is \"Artificial intelligence and audio programming languages\", with a strong focus on computer-aided music languages (Faust, ChucK, and PureData). Full program, details of the talks and registration on the PAW website . >> September 09, 2023: faust-web-component released ! Result of Ian Clester Google Summer of Code project, the faust-web-component package provides two web components for embedding interactive Faust snippets in web pages: <faust-editor> displays an editor (using CodeMirror 6 ) with executable, editable Faust code, along with some bells & whistles (controls, block diagram, plots) in a side pane. This component is ideal for demonstrating some code in Faust and allowing the reader to try it out and tweak it themselves without having to leave the page, and can been tested here . <faust-widget> just shows the controls and does not allow editing, so it serves simply as a way to embed interactive DSP, and can been tested here . These components are built on top of faustwasm and faust-ui packages and is released as a npm package . >> September 06, 2023: faust2rnbo released ! The faust2rnbo tool transforms a Faust DSP program into a RNBO patch containing a rnbo~ object and including the codebox code as a subpatch. The tool has been deployed on the Faust remote compilation service, to be used from the Faust Web IDE . All is explained in Using Faust in RNBO with codebox~ tutorial and can be used with the just released Max 8.5.6 version . >> August 28, 2023: Google Summer of Code projects finished Automatic Differentiation in the Faust Compiler aimed at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project was worked by Thomas Rushton and completed with this Pull Request , and finally integrated in the Faust master-branch . Better Faust on the Web aimed at enhancing Faust\u2019s support for the web platform, and was worked on by Ian Clester . Transitioning the Faust web tools to a rewritten TypeScript version has been completed and deployed in updated versions of the Faust editor and Faust playground and soon in the Faust Web IDE with this Pull Request . A Faust web component embedding the libfaust JS/WebAssembly compiler has been developed and will be used soon in the Faust documentation . The development is fully detailed in this blog post . Thanks Thomas Rushton and Ian Clester for the hard work during the three months period, and Agathe Herrou , David Braun and Jason Freeman for helping mentoring the two projects. >> May 15, 2023: ADCx San Francisco Audio Dev Talks The Audio Developer Conference San Francisco is a one day meet-up for audio developers by the bay. Two conferences are talking about Faust: High-Level Programming of FPGAs for Audio Real-Time Signal Processing Applications by Romain Michon, which can be seen here . Using Faust in JUCE Projects by Julius Smith, which can be seen here . And even the following one with ChatGPT generating running Faust code: Democratization of Audio Dev: How it started, Where it's going by Aurelius Prochazka. >> May 04, 2023: Two Google Summer of Code projects attributed Two projects have finally been attributed to GRAME: Automatic Differentiation in the Faust Compiler aims at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project will be worked on by Thomas Rushton . Better Faust on the Web aims at enhancing Faust\u2019s support for the web platform: transition the Faust web tools to a rewritten TypeScript version, extend the Faust Web IDE, enhance Faust\u2019s online documentation, and prototype an experimental platform for sharing Faust code on the web. The project will be worked on by Ian Clester . Welcome to both of you in the Faust community ! >> March 24, 2023: Zen Flute 1\u00b0 price at Guthman Musical Instrument 2023 Competition, with Faust inside ! The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board . >> February 22, 2023: GRAME has been selected as a Google Summer of Code 2023 mentor organization Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the second consecutive year, GRAME has been selected as a mentor organization for the Faust project. >> December 03, 2022: Programmable Audio Workshop (PAW-22) The 5th edition of Programmable Audio Workshop (PAW) will be held on December 3rd at the CITI laboratory of INSA Lyon on the La Doua campus. It will be organized this year by the EMERAUDE (Embedded Programmable Audio Systems) team created in 2022 and associating INSA-Lyon, INRIA and GRAME. With 7 conferences in the morning and 4 workshops in the afternoon, PAW addresses this year the theme of networked embedded audio systems, with a particular focus on spatialized sound and FPGAs (Field-Programmable Gate Arrays). Full program, details of the talks and registration on the PAW website . >> October 13, 2022: Google Summer of Code project finished Faust Integration in HISE aimed at integrating support for the Faust audio programming language into HISE, an extensive framework for the creation of sample-based virtual musical instruments. The project has been completed by Roman Sommer with the help of Christoph Hart as mentor, and announced here . >> June 5-12, 2022: Sound Music Computing (SMC-22) at Saint-Etienne (France) SMC-22 (Sound and Music Computing) is a multifaceted event around acoustics, music, and audio technology. It will take place in Saint-\u00c9tienne (France) on June 4-12, 2022 and will have the following theme: Music Technology and Design. As the first \"in person\" edition of SMC after 2 years of COVID-19 pandemic, we aim at widening the public of this event by (i) broadening the scope of SMC concerts through a digital art festival opened to the public, (ii) involving local schools and publics, and (iii) strengthening connections between academia and the industry. SMC-22 will be a combination of a Summer School (June 5-7, 2022), the International Faust Conference (June 7, 2022), the SMC Scientific Conference , Industry-Oriented Events , a Festival (June 8-11, 2022), and a STEAM (Science Technology Engineering Arts and Mathematics) Fair - \"Faites du son!\" (June 9-12). Most Faust related presentations are obviously part of IFC, but several SMC presentations are related to Faust. >> June 7, 2022: Third International Faust Conference (IFC-22) in conjunction with SMC 2022 at Saint-Etienne (France) The International Faust Conference aims at gathering researchers, developers, musicians, computer artists using the Faust programming language. The Third International Faust Conference (IFC-22) will propose sessions of paper presentations, as well as thematic round tables, demonstrations, and tutorials. Participants are encouraged to present current works, projects, etc. and to discuss future directions for Faust and its community. IFC-22 is organized by GRAME-CNCM , INRIA , and Universit\u00e9 Jean Monnet in conjunction with SMC 2022 . It will take place on June 7, 2022 at the Centre des Savoirs pour l\u2019Innovation (CSI) of the Universit\u00e9 Jean Monnet of Saint-Etienne (France). >> May 20, 2022: Two Google Summer of Code projects attributed Two projects have finally been attributed to GRAME: Faust Integration in HISE aims at integrating support for the Faust audio programming language into HISE , an extensive framework for the creation of sample-based virtual musical instruments. The project will be worked on by Roman Sommer . Integrating Faust Into the Bespoke DAW aims at extending the modular Bespoke engine with Faust, allowing for both static compilation of modules, and potentially dynamic programming within Bespoke. The project will be worked on by Drew James . Welcome to both of you in the Faust community ! >> March 7, 2022: GRAME has been selected as a Google Summer of Code 2022 mentor organization Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. GRAME has been selected as a mentor organization for the Faust project. >> February 5, 2022: Open Science Award for Open Source Research Software for Faust Great birthday present for the 20th anniversary of the Faust language! Developed by Grame since 2002, supported by a whole community of users and contributors, Faust is one of the four winners of the Open Science Award for Open Source Research Software (documentation category) awarded at the Open Science European Conference (OSEC). >> December 18, 2021: Programmable Audio Workshop (PAW-21) With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! The 6 talks and 4 workshops of PAW 2021 , will offer a unique opportunity to discover Procedural Audio in relation with video game engines! >> February 1, 2021: Faust Physical Modeling Workshop -- Online Event Faust has been used for the physical modeling of musical instruments for many years now. Various tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day workshop was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques. It took place online on Feb. 1, 2021, 3-9pm GMT+1. Additional information about this event can be found here . >> November 21, 2020: Programmable Audio Workshop (PAW-20) -- Online Event With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! PAW-20 will be a fully online event. Information about the free registration process will be posted soon! PAW 2019 >> December 1-2, 2020: International Faust Conference 2020 (IFC-20) -- Online Event The Second International Faust Conference (IFC-20) will take place at the Maison des Sciences de l\u2019Homme Paris Nord (Saint-Denis, France) on December 1-2, 2020. It aims at gathering researchers, developers, musicians, computer artists using the Faust programming language to present current works, creations and projects and discuss future directions for Faust and its community. The 2020 edition is organized by the CICM (Centre de Recherches Informatique et Cr\u00e9ation Musicale) / MUSIDANSE Lab / Universit\u00e9 Paris 8. IFC 2018 >> FAST Project: Fast Audio Signal Processing Technologies on FPGA The FAST project will start in March 2021! It is funded by the Agence Nationale de la Recherche (ANR -- the French National Research Agency). It gathers the strength of GRAME-CNCM , CITI Lab (INSA Lyon) , and LMFA (\u00c9cole Centrale Lyon) towards two goals: facilitate the design of ultra-low latency embedded systems for real-time audio signal processing, use such systems in the context of active control of acoustics. Faust will play a central role in this project.","title":"Home"},{"location":"#what-is-faust","text":"Faust (Functional Audio Stream) is a functional programming language for sound synthesis and audio processing with a strong focus on the design of synthesizers, musical instruments, audio effects, etc. created at the GRAME-CNCM Research Department . Faust targets high-performance signal processing applications and audio plug-ins for a variety of platforms and standards. The core component of Faust is its compiler. It allows to \"translate\" any Faust digital signal processing (DSP) specification to a wide range of non-domain specific languages such as C++, C, LLVM bit code, WebAssembly, Rust, etc. In this regard, Faust can be seen as an alternative to C++ but is much simpler and intuitive to learn. Thanks to a wrapping system called \"architectures,\" codes generated by Faust can be easily compiled into a wide variety of objects ranging from audio plug-ins to standalone applications or smartphone and web apps, etc. The Faust Web IDE","title":"What is Faust?"},{"location":"#getting-started","text":"","title":"Getting Started"},{"location":"#if-youre-in-a-hurry","text":"If you\u2019re in a hurry and just wanna have a look at how Faust programs look like, you can simply check the Faust Examples .","title":"If You're in a Hurry"},{"location":"#if-you-wanna-get-started-with-faust","text":"If you\u2019re looking for a step by step tutorial of approximately 2 hours that will walk you through writing simple Faust programs and give you an overview of what Faust can do, have a look at our Quick Start Tutorial .","title":"If You Wanna Get Started With Faust"},{"location":"#if-youre-looking-for-the-manual","text":"Faust\u2019s syntax and features are thoroughly documented in the Faust Manual . This resource contains hundreds of code examples and many short tutorials.","title":"If You\u2019re Looking for the \"Manual\""},{"location":"#if-youre-looking-for-the-documentation-of-a-function-in-the-faust-libraries","text":"The documentation of Faust's standard libraries is automatically generated directly from the libraries' source code.","title":"If You\u2019re Looking for the Documentation of a Function in the Faust Libraries"},{"location":"#if-you-prefer-video-tutorials","text":"Check out the Faust Kadenze course .","title":"If You prefer Video Tutorials"},{"location":"#if-you-want-to-discover-projects-powered-by-faust","text":"Check out the Powered by Faust page.","title":"If You want to discover Projects Powered by Faust"},{"location":"#if-youre-looking-for-papers-on-faust","text":"Check out Faust papers and reports on HAL .","title":"If You're looking for Papers on Faust"},{"location":"#faust-news","text":"","title":"Faust News"},{"location":"#february-21-2024-grame-has-been-selected-as-a-google-summer-of-code-2024-mentor-organization","text":"Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the third consecutive year, GRAME has been selected as a mentor organization for the Faust project.","title":"&gt;&gt; February 21, 2024: GRAME has been selected as a Google Summer of Code 2024 mentor organization"},{"location":"#december-02-2023-programmable-audio-workshop-paw-23","text":"The 6th edition of Programmable Audio Workshop (PAW) will be held on December 2rd at the Marie Curie Library of INSA Lyon (France) on the La Doua campus and is organised by the Emeraude INRIA/INSA/GRAME-CNCM team. This year's theme is \"Artificial intelligence and audio programming languages\", with a strong focus on computer-aided music languages (Faust, ChucK, and PureData). Full program, details of the talks and registration on the PAW website .","title":"&gt;&gt; December 02, 2023: Programmable Audio Workshop (PAW-23)"},{"location":"#september-09-2023-faust-web-component-released","text":"Result of Ian Clester Google Summer of Code project, the faust-web-component package provides two web components for embedding interactive Faust snippets in web pages: <faust-editor> displays an editor (using CodeMirror 6 ) with executable, editable Faust code, along with some bells & whistles (controls, block diagram, plots) in a side pane. This component is ideal for demonstrating some code in Faust and allowing the reader to try it out and tweak it themselves without having to leave the page, and can been tested here . <faust-widget> just shows the controls and does not allow editing, so it serves simply as a way to embed interactive DSP, and can been tested here . These components are built on top of faustwasm and faust-ui packages and is released as a npm package .","title":"&gt;&gt; September 09, 2023: faust-web-component released !"},{"location":"#september-06-2023-faust2rnbo-released","text":"The faust2rnbo tool transforms a Faust DSP program into a RNBO patch containing a rnbo~ object and including the codebox code as a subpatch. The tool has been deployed on the Faust remote compilation service, to be used from the Faust Web IDE . All is explained in Using Faust in RNBO with codebox~ tutorial and can be used with the just released Max 8.5.6 version .","title":"&gt;&gt; September 06, 2023: faust2rnbo released !"},{"location":"#august-28-2023-google-summer-of-code-projects-finished","text":"Automatic Differentiation in the Faust Compiler aimed at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project was worked by Thomas Rushton and completed with this Pull Request , and finally integrated in the Faust master-branch . Better Faust on the Web aimed at enhancing Faust\u2019s support for the web platform, and was worked on by Ian Clester . Transitioning the Faust web tools to a rewritten TypeScript version has been completed and deployed in updated versions of the Faust editor and Faust playground and soon in the Faust Web IDE with this Pull Request . A Faust web component embedding the libfaust JS/WebAssembly compiler has been developed and will be used soon in the Faust documentation . The development is fully detailed in this blog post . Thanks Thomas Rushton and Ian Clester for the hard work during the three months period, and Agathe Herrou , David Braun and Jason Freeman for helping mentoring the two projects.","title":"&gt;&gt; August 28, 2023: Google Summer of Code projects finished"},{"location":"#may-15-2023-adcx-san-francisco-audio-dev-talks","text":"The Audio Developer Conference San Francisco is a one day meet-up for audio developers by the bay. Two conferences are talking about Faust: High-Level Programming of FPGAs for Audio Real-Time Signal Processing Applications by Romain Michon, which can be seen here . Using Faust in JUCE Projects by Julius Smith, which can be seen here . And even the following one with ChatGPT generating running Faust code: Democratization of Audio Dev: How it started, Where it's going by Aurelius Prochazka.","title":"&gt;&gt; May 15, 2023: ADCx San Francisco Audio Dev Talks"},{"location":"#may-04-2023-two-google-summer-of-code-projects-attributed","text":"Two projects have finally been attributed to GRAME: Automatic Differentiation in the Faust Compiler aims at adding Automatic differentiation directly in the compiler, so that gradient calculation can be carried out natively in Faust, with applications in Machine Learning algorithms. The project will be worked on by Thomas Rushton . Better Faust on the Web aims at enhancing Faust\u2019s support for the web platform: transition the Faust web tools to a rewritten TypeScript version, extend the Faust Web IDE, enhance Faust\u2019s online documentation, and prototype an experimental platform for sharing Faust code on the web. The project will be worked on by Ian Clester . Welcome to both of you in the Faust community !","title":"&gt;&gt; May 04, 2023: Two Google Summer of Code projects attributed"},{"location":"#march-24-2023-zen-flute-1-price-at-guthman-musical-instrument-2023-competition-with-faust-inside","text":"The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board .","title":"&gt;&gt; March 24, 2023: Zen Flute 1\u00b0 price at Guthman Musical Instrument 2023 Competition, with Faust inside !"},{"location":"#february-22-2023-grame-has-been-selected-as-a-google-summer-of-code-2023-mentor-organization","text":"Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. For the second consecutive year, GRAME has been selected as a mentor organization for the Faust project.","title":"&gt;&gt; February 22, 2023: GRAME has been selected as a Google Summer of Code 2023 mentor organization"},{"location":"#december-03-2022-programmable-audio-workshop-paw-22","text":"The 5th edition of Programmable Audio Workshop (PAW) will be held on December 3rd at the CITI laboratory of INSA Lyon on the La Doua campus. It will be organized this year by the EMERAUDE (Embedded Programmable Audio Systems) team created in 2022 and associating INSA-Lyon, INRIA and GRAME. With 7 conferences in the morning and 4 workshops in the afternoon, PAW addresses this year the theme of networked embedded audio systems, with a particular focus on spatialized sound and FPGAs (Field-Programmable Gate Arrays). Full program, details of the talks and registration on the PAW website .","title":"&gt;&gt; December 03, 2022: Programmable Audio Workshop (PAW-22)"},{"location":"#october-13-2022-google-summer-of-code-project-finished","text":"Faust Integration in HISE aimed at integrating support for the Faust audio programming language into HISE, an extensive framework for the creation of sample-based virtual musical instruments. The project has been completed by Roman Sommer with the help of Christoph Hart as mentor, and announced here .","title":"&gt;&gt; October 13, 2022: Google Summer of Code project finished"},{"location":"#june-5-12-2022-sound-music-computing-smc-22-at-saint-etienne-france","text":"SMC-22 (Sound and Music Computing) is a multifaceted event around acoustics, music, and audio technology. It will take place in Saint-\u00c9tienne (France) on June 4-12, 2022 and will have the following theme: Music Technology and Design. As the first \"in person\" edition of SMC after 2 years of COVID-19 pandemic, we aim at widening the public of this event by (i) broadening the scope of SMC concerts through a digital art festival opened to the public, (ii) involving local schools and publics, and (iii) strengthening connections between academia and the industry. SMC-22 will be a combination of a Summer School (June 5-7, 2022), the International Faust Conference (June 7, 2022), the SMC Scientific Conference , Industry-Oriented Events , a Festival (June 8-11, 2022), and a STEAM (Science Technology Engineering Arts and Mathematics) Fair - \"Faites du son!\" (June 9-12). Most Faust related presentations are obviously part of IFC, but several SMC presentations are related to Faust.","title":"&gt;&gt; June 5-12, 2022: Sound Music Computing (SMC-22) at Saint-Etienne (France)"},{"location":"#june-7-2022-third-international-faust-conference-ifc-22-in-conjunction-with-smc-2022-at-saint-etienne-france","text":"The International Faust Conference aims at gathering researchers, developers, musicians, computer artists using the Faust programming language. The Third International Faust Conference (IFC-22) will propose sessions of paper presentations, as well as thematic round tables, demonstrations, and tutorials. Participants are encouraged to present current works, projects, etc. and to discuss future directions for Faust and its community. IFC-22 is organized by GRAME-CNCM , INRIA , and Universit\u00e9 Jean Monnet in conjunction with SMC 2022 . It will take place on June 7, 2022 at the Centre des Savoirs pour l\u2019Innovation (CSI) of the Universit\u00e9 Jean Monnet of Saint-Etienne (France).","title":"&gt;&gt; June 7, 2022: Third International Faust Conference (IFC-22) in conjunction with SMC 2022 at Saint-Etienne (France)"},{"location":"#may-20-2022-two-google-summer-of-code-projects-attributed","text":"Two projects have finally been attributed to GRAME: Faust Integration in HISE aims at integrating support for the Faust audio programming language into HISE , an extensive framework for the creation of sample-based virtual musical instruments. The project will be worked on by Roman Sommer . Integrating Faust Into the Bespoke DAW aims at extending the modular Bespoke engine with Faust, allowing for both static compilation of modules, and potentially dynamic programming within Bespoke. The project will be worked on by Drew James . Welcome to both of you in the Faust community !","title":"&gt;&gt; May 20, 2022: Two Google Summer of Code projects attributed"},{"location":"#march-7-2022-grame-has-been-selected-as-a-google-summer-of-code-2022-mentor-organization","text":"Google Summer of Code is a global, online program focused on bringing new contributors into open source software development. GSoC Contributors work with an open source organization on a 12+ week programming project under the guidance of mentors. GRAME has been selected as a mentor organization for the Faust project.","title":"&gt;&gt; March 7, 2022: GRAME has been selected as a Google Summer of Code 2022 mentor organization"},{"location":"#february-5-2022-open-science-award-for-open-source-research-software-for-faust","text":"Great birthday present for the 20th anniversary of the Faust language! Developed by Grame since 2002, supported by a whole community of users and contributors, Faust is one of the four winners of the Open Science Award for Open Source Research Software (documentation category) awarded at the Open Science European Conference (OSEC).","title":"&gt;&gt; February 5, 2022: Open Science Award for Open Source Research Software for Faust"},{"location":"#december-18-2021-programmable-audio-workshop-paw-21","text":"With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! The 6 talks and 4 workshops of PAW 2021 , will offer a unique opportunity to discover Procedural Audio in relation with video game engines!","title":"&gt;&gt; December 18, 2021: Programmable Audio Workshop (PAW-21)"},{"location":"#february-1-2021-faust-physical-modeling-workshop-online-event","text":"Faust has been used for the physical modeling of musical instruments for many years now. Various tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day workshop was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques. It took place online on Feb. 1, 2021, 3-9pm GMT+1. Additional information about this event can be found here .","title":"&gt;&gt; February 1, 2021: Faust Physical Modeling Workshop -- Online Event"},{"location":"#november-21-2020-programmable-audio-workshop-paw-20-online-event","text":"With a combination of talks and workshops, PAW is an intensive day devoted to electronic sounds and programmable audio technologies! PAW-20 will be a fully online event. Information about the free registration process will be posted soon! PAW 2019","title":"&gt;&gt; November 21, 2020: Programmable Audio Workshop (PAW-20) -- Online Event"},{"location":"#december-1-2-2020-international-faust-conference-2020-ifc-20-online-event","text":"The Second International Faust Conference (IFC-20) will take place at the Maison des Sciences de l\u2019Homme Paris Nord (Saint-Denis, France) on December 1-2, 2020. It aims at gathering researchers, developers, musicians, computer artists using the Faust programming language to present current works, creations and projects and discuss future directions for Faust and its community. The 2020 edition is organized by the CICM (Centre de Recherches Informatique et Cr\u00e9ation Musicale) / MUSIDANSE Lab / Universit\u00e9 Paris 8. IFC 2018","title":"&gt;&gt; December 1-2, 2020: International Faust Conference 2020 (IFC-20) -- Online Event"},{"location":"#fast-project-fast-audio-signal-processing-technologies-on-fpga","text":"The FAST project will start in March 2021! It is funded by the Agence Nationale de la Recherche (ANR -- the French National Research Agency). It gathers the strength of GRAME-CNCM , CITI Lab (INSA Lyon) , and LMFA (\u00c9cole Centrale Lyon) towards two goals: facilitate the design of ultra-low latency embedded systems for real-time audio signal processing, use such systems in the context of active control of acoustics. Faust will play a central role in this project.","title":"&gt;&gt; FAST Project: Fast Audio Signal Processing Technologies on FPGA"},{"location":"Smartphone-Privacy-Policy/","text":"Privacy Policy This smartphone application is a\u200b musical instrument.\u200b It doesn\u2019t collect any personal data of any kind. The microphone input is only used for real-time sound production and no audio recording is ever collected or transmitted. GRAME-CNCM - Centre National de Cr\u00e9ation Musicale, 26 rue Emile Decorps 69100 Villeurbanne FRANCE Phone: +33 4 72 07 37 00","title":"Smartphone Privacy Policy"},{"location":"Smartphone-Privacy-Policy/#privacy-policy","text":"This smartphone application is a\u200b musical instrument.\u200b It doesn\u2019t collect any personal data of any kind. The microphone input is only used for real-time sound production and no audio recording is ever collected or transmitted. GRAME-CNCM - Centre National de Cr\u00e9ation Musicale, 26 rue Emile Decorps 69100 Villeurbanne FRANCE Phone: +33 4 72 07 37 00","title":"Privacy Policy"},{"location":"about/","text":"The Faust Project The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Bart Brouns, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Ian Clester, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, R\u00e9mi Georges, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Agathe Herrou, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Oleg Nesterov, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Dirk Roosenburg, Thomas Rushton, Dario Sanfilippo, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Roman Sommer, Michael Wilson. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"About"},{"location":"about/#the-faust-project","text":"The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Bart Brouns, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Ian Clester, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, R\u00e9mi Georges, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Agathe Herrou, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Oleg Nesterov, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Dirk Roosenburg, Thomas Rushton, Dario Sanfilippo, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Roman Sommer, Michael Wilson. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"The Faust Project"},{"location":"downloads/","text":"Faust Downloads Faust comes in many different forms and it can be confusing to know what to install to start using this tool. We recommend you to have a look at the overview of the Faust universe section of the Faust manual . That being said, most of the features of Faust are accessible through the >> Faust Web IDE << so we recommend most people to use this tools which doesn't require any installation. Now, if you really wish to have a local version of Faust on your system, this page should give you an overview of the options that you have. Faust Compiler & libfaust Windows Look for the most recent Faust-XXX-win64.exe on: https://github.com/grame-cncm/faust/releases MacOS Look for the most recent Faust-XXX.dmg on: https://github.com/grame-cncm/faust/releases or use MacPorts or Homebrew package managers Linux Look for the most recent Faust-XXX.tar.gz on: https://github.com/grame-cncm/faust/releases or use your favorite package installer depending of your distribution Building Faust from the Source Alternatively, you might want to build Faust from scratch. For that you can either get the latest release of the Faust source or clone it from our GitRepo . Build instructions are available here . FaustLive FaustLive is an \"on-the-fly\" compiler for Faust (see the overview of the Faust universe for more information) allowing us to instantly run Faust programs. Windows Look for the most recent FaustLive-XXX-win64.exe on: https://github.com/grame-cncm/faustlive/releases MacOS Look for the most recent FaustLive-XXX.dmg on: https://github.com/grame-cncm/faustlive/releases Linux Look for the most recent FaustLive-XXX.tar.gz on: https://github.com/grame-cncm/faustlive/releases Building FaustLive from the Source Alternatively, you might want to build FaustLive from scratch. For that you can either get the latest release of the FaustLive source or clone it from our GitRepo . Faustgen Faustgen is a Max/MSP object to compile Faust code dynamically (see the overview of the Faust universe for more information). Windows Look for the most recent faustgen-XXX-win64.zip on: https://github.com/grame-cncm/faust/releases MacOS Look for the most recent faustgen-XXX-macosx.dmg on: https://github.com/grame-cncm/faust/releases FaustWorks FaustWorks is an IDE for the Faust compiler. It is not actively maintained and you should use Faust WEB IDE instead. The source code is available from the FaustWorks github repository","title":"Downloads"},{"location":"downloads/#faust-downloads","text":"Faust comes in many different forms and it can be confusing to know what to install to start using this tool. We recommend you to have a look at the overview of the Faust universe section of the Faust manual . That being said, most of the features of Faust are accessible through the >> Faust Web IDE << so we recommend most people to use this tools which doesn't require any installation. Now, if you really wish to have a local version of Faust on your system, this page should give you an overview of the options that you have.","title":"Faust Downloads"},{"location":"downloads/#faust-compiler-libfaust","text":"","title":"Faust Compiler &amp; libfaust"},{"location":"downloads/#windows","text":"Look for the most recent Faust-XXX-win64.exe on: https://github.com/grame-cncm/faust/releases","title":"Windows"},{"location":"downloads/#macos","text":"Look for the most recent Faust-XXX.dmg on: https://github.com/grame-cncm/faust/releases or use MacPorts or Homebrew package managers","title":"MacOS"},{"location":"downloads/#linux","text":"Look for the most recent Faust-XXX.tar.gz on: https://github.com/grame-cncm/faust/releases or use your favorite package installer depending of your distribution","title":"Linux"},{"location":"downloads/#building-faust-from-the-source","text":"Alternatively, you might want to build Faust from scratch. For that you can either get the latest release of the Faust source or clone it from our GitRepo . Build instructions are available here .","title":"Building Faust from the Source"},{"location":"downloads/#faustlive","text":"FaustLive is an \"on-the-fly\" compiler for Faust (see the overview of the Faust universe for more information) allowing us to instantly run Faust programs.","title":"FaustLive"},{"location":"downloads/#windows_1","text":"Look for the most recent FaustLive-XXX-win64.exe on: https://github.com/grame-cncm/faustlive/releases","title":"Windows"},{"location":"downloads/#macos_1","text":"Look for the most recent FaustLive-XXX.dmg on: https://github.com/grame-cncm/faustlive/releases","title":"MacOS"},{"location":"downloads/#linux_1","text":"Look for the most recent FaustLive-XXX.tar.gz on: https://github.com/grame-cncm/faustlive/releases","title":"Linux"},{"location":"downloads/#building-faustlive-from-the-source","text":"Alternatively, you might want to build FaustLive from scratch. For that you can either get the latest release of the FaustLive source or clone it from our GitRepo .","title":"Building FaustLive from the Source"},{"location":"downloads/#faustgen","text":"Faustgen is a Max/MSP object to compile Faust code dynamically (see the overview of the Faust universe for more information).","title":"Faustgen"},{"location":"downloads/#windows_2","text":"Look for the most recent faustgen-XXX-win64.zip on: https://github.com/grame-cncm/faust/releases","title":"Windows"},{"location":"downloads/#macos_2","text":"Look for the most recent faustgen-XXX-macosx.dmg on: https://github.com/grame-cncm/faust/releases","title":"MacOS"},{"location":"downloads/#faustworks","text":"FaustWorks is an IDE for the Faust compiler. It is not actively maintained and you should use Faust WEB IDE instead. The source code is available from the FaustWorks github repository","title":"FaustWorks"},{"location":"licence/","text":"The Faust Project The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Michael Wilson, Bart Brouns, Dirk Roosenburg. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"The Faust Project"},{"location":"licence/#the-faust-project","text":"The Faust Project has started in 2002. It is actively developed by the GRAME-CNCM Research Department . Many persons are contributing to the Faust project, by providing code for the compiler, architecture files, libraries, examples, documentation, scripts, bug reports, ideas, etc. We would like in particular to thank: Fons Adriaensen, Karim Barkati, J\u00e9r\u00f4me Barth\u00e9lemy, Tim Blechmann, Tiziano Bole, Alain Bonardi, Thomas Charbonnel, Raffaele Ciavarella, Julien Colafrancesco, Damien Cramet, Sarah Denoux, \u00c9tienne Gaudrin, Olivier Guillerminet, Pierre Guillot, Albert Gr\u00e4f, Pierre Jouvelot, Stefan Kersten, Victor Lazzarini, Matthieu Leberre, Mathieu Leroi, Fernando Lopez-Lezcano, Kjetil Matheussen, Hermann Meyer, R\u00e9my Muller, Raphael Panis, Eliott Paris, Reza Payami, Laurent Pottier, Sampo Savolainen, Nicolas Scaringella, Anne Sedes, Priyanka Shekar, Stephen Sinclair, Travis Skare, Julius Smith, Mike Solomon, Michael Wilson, Bart Brouns, Dirk Roosenburg. as well as our colleagues at GRAME : Dominique Fober Christophe Lebreton St\u00e9phane Letz Romain Michon Yann Orlarey We would like also to thank for their financial support: the French Ministry of Culture , the Auvergne-Rh\u00f4ne-Alpes Region , the City of Lyon , the French National Research Agency (ANR) .","title":"The Faust Project"},{"location":"community/bugs/","text":"Reporting Bugs The best way to report a bug in Faust or in any of its associated tool is to submit an issue on the corresponding Git repository: Report a bug in the Faust Compiler , libfaust , faustgen or any other tool part of the Faust distribution Report a bug in the Faust Web Editor Report a bug in the Faust Web IDE Report a bug in the Faust Playground Report a bug in FaustLive Report a bug in FaustWorks Report a bug in the Faust Libraries Report a bug in the Faust Web Services Report a bug in the Faust Online Compiler Report a bug/typo on this website .","title":"Reporting Bugs"},{"location":"community/bugs/#reporting-bugs","text":"The best way to report a bug in Faust or in any of its associated tool is to submit an issue on the corresponding Git repository: Report a bug in the Faust Compiler , libfaust , faustgen or any other tool part of the Faust distribution Report a bug in the Faust Web Editor Report a bug in the Faust Web IDE Report a bug in the Faust Playground Report a bug in FaustLive Report a bug in FaustWorks Report a bug in the Faust Libraries Report a bug in the Faust Web Services Report a bug in the Faust Online Compiler Report a bug/typo on this website .","title":"Reporting Bugs"},{"location":"community/events/","text":"Events Faust Day 2023 Faust Day took place at the Center for Computer Research in Music and Acoustics (CCRMA) at Stanford University on May 20th, 2023. It aimed at: giving an overview of the most recent developments in the Faust programming language, giving an introductory tutorial for those who never used Faust. Where is Faust Going as a Programming Language? -- Yann Orlarey Overview of Recent Developments in the Faust General Ecosystem -- St\u00e9phane Letz Faust and AI -- David Braun Faust in Real-Time Expressive Virtual Musical Instruments -- Julius O. Smith Real-Time Audio DSP With Faust and FPGAs -- Romain Michon Faust Physical Modeling Workshop Faust has been used for the physical modeling of musical instruments for many years now. Different tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day online workshop which took place on Feb. 1, 2021 was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques. Creating Circuit-Bendable Wave-Digital Models of Analog Audio Circuits in Faust -- Dirk Roosenburg Download this workshop's code here Wave-digital models are a well researched and popular approach for creating virtual-analog models of audio circuits for use in audio processing. wdmodels.lib is a new addition to the Faust Libraries that supports easy creation of these models in Faust. In this workshop, we will introduce the technique of wave-digital modeling of circuits by analyzing several audio circuits and exploring their implementation in wdmodels.lib . We also will discuss library support of more complex implementation tasks associated with wave-digital models, such as R-type adaptors and Multiple/Multiport non-linearities. Finally, we will conclude by exploring the capacity of Faust to \"circuit-bend\" our wave-digital models. Note : the workshop's code has been adapted to work with the latest version of the wdmodels.lib library embedded in the Faust Web IDE. You'll see some tiny syntax differences between the video and the new syntax. An Introduction to Mass-Interaction Modelling in Faust -- James Leonard and J\u00e9r\u00f4me Villeneuve Download this workshop's code here This workshop proposes an introduction to mass-interaction (sometimes referred to as mass-spring) modelling for sound synthesis in the Faust environment. After a brief historic introduction to this field, we will give a hands on tutorial on the mi_faust library, which allows simulating modular physical constructions in Faust, as well as online model scripting tools that allow for efficient model design and code generation. We will conclude with ongoing developments and perspectives, in particular regarding performance issues, possible extensions to 3-DoF physics, and the importance of modelling frameworks that allow for a creative approach to physical model design. Finite Difference Schemes Synthesis in Faust -- Riccardo Russo Download this workshop's code here Over the years, Faust proved to be a powerful tool for developing physical modeling synthesis. However, coding finite difference schemes models has always been complicated, in fact, their implementation in imperative programming languages is typically achieved using data structures, which are not available in Faust. This workshop will introduce the fds library, a new tool which allows to code linear, explicit finite difference schemes physical models in Faust, based on a cellular automata formalism. We will start with a brief introduction on how finite difference schemes work and what is their place within the scope physical modeling techniques. Then, we will focus on how to implement the algorithms we obtained on paper in Faust and, lastly, we will see how the fds library can be used to code such algorithms in a much easier way. By the end of the tutorial you should have quite an understanding on the basic principles of finite difference schemes, on the roles of the different functions inside the fds library and on how they can be used to easily obtain a working fds physical model. break Introduction to the Faust Physical Modeling Toolkit -- Romain Michon Download this workshop's code here A series of tools to facilitate the implementation of waveguide and modal physical models of musical instruments have been developed over the years by the Faust team to become the \"Faust Physical Modeling Toolkit.\" This comprises the Faust Physical Modeling library ( pm.lib ) as well as mesh2faust , a tool to convert 3D meshes into modal physical models compatible with pm.lib . During this workshop, we will provide a step-by-step tutorial on how to use these different tools to implement various kinds of physical models from scratch. Overview of Physical Modeling Formulations and Faust Implementations -- Julius O. Smith Download this workshop's code is available at https://ccrma.stanford.edu/~jos/aspf/Appendix_A_State_Space_Models.html#code:statespace and https://ccrma.stanford.edu/~jos/aspf/State_Space_BiQuad_FAUST.html#code:statespaceBiquad A summary of methods for physical modeling is followed by some examples in Faust. Physical models normally start out as differential equations which are then digitized to yield finite-difference schemes as were discussed earlier in this workshop. Wave digital and digital waveguide formulations were also discussed. Two additional topics are state-space models and modal representations which can be obtained by diagonalizing state-space models. As a result, this talk focuses primarily on state-space models and how to diagonalize them.","title":"Events"},{"location":"community/events/#events","text":"","title":"Events"},{"location":"community/events/#faust-day-2023","text":"Faust Day took place at the Center for Computer Research in Music and Acoustics (CCRMA) at Stanford University on May 20th, 2023. It aimed at: giving an overview of the most recent developments in the Faust programming language, giving an introductory tutorial for those who never used Faust.","title":"Faust Day 2023"},{"location":"community/events/#where-is-faust-going-as-a-programming-language-yann-orlarey","text":"","title":"Where is Faust Going as a Programming Language? -- Yann Orlarey"},{"location":"community/events/#overview-of-recent-developments-in-the-faust-general-ecosystem-stephane-letz","text":"","title":"Overview of Recent Developments in the Faust General Ecosystem -- St\u00e9phane Letz"},{"location":"community/events/#faust-and-ai-david-braun","text":"","title":"Faust and AI -- David Braun"},{"location":"community/events/#faust-in-real-time-expressive-virtual-musical-instruments-julius-o-smith","text":"","title":"Faust in Real-Time Expressive Virtual Musical Instruments -- Julius O. Smith"},{"location":"community/events/#real-time-audio-dsp-with-faust-and-fpgas-romain-michon","text":"","title":"Real-Time Audio DSP With Faust and FPGAs -- Romain Michon"},{"location":"community/events/#faust-physical-modeling-workshop","text":"Faust has been used for the physical modeling of musical instruments for many years now. Different tools have been developed recently to address the needs of various modeling techniques (e.g., finite difference scheme, waveguides, mass interaction, etc.). The goal of this one day online workshop which took place on Feb. 1, 2021 was to provide a series of interactive one-hour tutorials on these tools as well as some background on their related modeling techniques.","title":"Faust Physical Modeling Workshop"},{"location":"community/events/#creating-circuit-bendable-wave-digital-models-of-analog-audio-circuits-in-faust-dirk-roosenburg","text":"Download this workshop's code here Wave-digital models are a well researched and popular approach for creating virtual-analog models of audio circuits for use in audio processing. wdmodels.lib is a new addition to the Faust Libraries that supports easy creation of these models in Faust. In this workshop, we will introduce the technique of wave-digital modeling of circuits by analyzing several audio circuits and exploring their implementation in wdmodels.lib . We also will discuss library support of more complex implementation tasks associated with wave-digital models, such as R-type adaptors and Multiple/Multiport non-linearities. Finally, we will conclude by exploring the capacity of Faust to \"circuit-bend\" our wave-digital models. Note : the workshop's code has been adapted to work with the latest version of the wdmodels.lib library embedded in the Faust Web IDE. You'll see some tiny syntax differences between the video and the new syntax.","title":"Creating Circuit-Bendable Wave-Digital Models of Analog Audio Circuits in Faust -- Dirk Roosenburg"},{"location":"community/events/#an-introduction-to-mass-interaction-modelling-in-faust-james-leonard-and-jerome-villeneuve","text":"Download this workshop's code here This workshop proposes an introduction to mass-interaction (sometimes referred to as mass-spring) modelling for sound synthesis in the Faust environment. After a brief historic introduction to this field, we will give a hands on tutorial on the mi_faust library, which allows simulating modular physical constructions in Faust, as well as online model scripting tools that allow for efficient model design and code generation. We will conclude with ongoing developments and perspectives, in particular regarding performance issues, possible extensions to 3-DoF physics, and the importance of modelling frameworks that allow for a creative approach to physical model design.","title":"An Introduction to Mass-Interaction Modelling in Faust -- James Leonard and J\u00e9r\u00f4me Villeneuve"},{"location":"community/events/#finite-difference-schemes-synthesis-in-faust-riccardo-russo","text":"Download this workshop's code here Over the years, Faust proved to be a powerful tool for developing physical modeling synthesis. However, coding finite difference schemes models has always been complicated, in fact, their implementation in imperative programming languages is typically achieved using data structures, which are not available in Faust. This workshop will introduce the fds library, a new tool which allows to code linear, explicit finite difference schemes physical models in Faust, based on a cellular automata formalism. We will start with a brief introduction on how finite difference schemes work and what is their place within the scope physical modeling techniques. Then, we will focus on how to implement the algorithms we obtained on paper in Faust and, lastly, we will see how the fds library can be used to code such algorithms in a much easier way. By the end of the tutorial you should have quite an understanding on the basic principles of finite difference schemes, on the roles of the different functions inside the fds library and on how they can be used to easily obtain a working fds physical model.","title":"Finite Difference Schemes Synthesis in Faust -- Riccardo Russo"},{"location":"community/events/#break","text":"","title":"break"},{"location":"community/events/#introduction-to-the-faust-physical-modeling-toolkit-romain-michon","text":"Download this workshop's code here A series of tools to facilitate the implementation of waveguide and modal physical models of musical instruments have been developed over the years by the Faust team to become the \"Faust Physical Modeling Toolkit.\" This comprises the Faust Physical Modeling library ( pm.lib ) as well as mesh2faust , a tool to convert 3D meshes into modal physical models compatible with pm.lib . During this workshop, we will provide a step-by-step tutorial on how to use these different tools to implement various kinds of physical models from scratch.","title":"Introduction to the Faust Physical Modeling Toolkit -- Romain Michon"},{"location":"community/events/#overview-of-physical-modeling-formulations-and-faust-implementations-julius-o-smith","text":"Download this workshop's code is available at https://ccrma.stanford.edu/~jos/aspf/Appendix_A_State_Space_Models.html#code:statespace and https://ccrma.stanford.edu/~jos/aspf/State_Space_BiQuad_FAUST.html#code:statespaceBiquad A summary of methods for physical modeling is followed by some examples in Faust. Physical models normally start out as differential equations which are then digitized to yield finite-difference schemes as were discussed earlier in this workshop. Wave digital and digital waveguide formulations were also discussed. Two additional topics are state-space models and modal representations which can be obtained by diagonalizing state-space models. As a result, this talk focuses primarily on state-space models and how to diagonalize them.","title":"Overview of Physical Modeling Formulations and Faust Implementations -- Julius O. Smith"},{"location":"community/help/","text":"Getting Help Faust Mailing Lists Mailing lists are the oldest way to reach out to the Faust community. If you have a question about the Faust language, the use of one of its associated tools (e.g., FaustLive, the web editor, etc.), or if you just want to follow the latest Faust news, please subscribe and ask your question to: the Faust Users Mailing List If you'd like to follow the development of Faust and of its associated tools and/or if you wish to contribute to it, please subscribe and ask your question to: the Faust Developers Mailing List Faust on discord Connect to the Faust discord server. The Audio Programmer community discord community has a #faust channel. Faust slack channel Slack can also be used to get help with Faust: https://faustaudio.slack.com or this link , but Faust on discord is the preferably way to go. Faust GitHub discussion The discussions can also take place on the Faust GitHub discussion forum .","title":"Getting Help"},{"location":"community/help/#getting-help","text":"","title":"Getting Help"},{"location":"community/help/#faust-mailing-lists","text":"Mailing lists are the oldest way to reach out to the Faust community. If you have a question about the Faust language, the use of one of its associated tools (e.g., FaustLive, the web editor, etc.), or if you just want to follow the latest Faust news, please subscribe and ask your question to: the Faust Users Mailing List If you'd like to follow the development of Faust and of its associated tools and/or if you wish to contribute to it, please subscribe and ask your question to: the Faust Developers Mailing List","title":"Faust Mailing Lists"},{"location":"community/help/#faust-on-discord","text":"Connect to the Faust discord server. The Audio Programmer community discord community has a #faust channel.","title":"Faust on discord"},{"location":"community/help/#faust-slack-channel","text":"Slack can also be used to get help with Faust: https://faustaudio.slack.com or this link , but Faust on discord is the preferably way to go.","title":"Faust slack channel"},{"location":"community/help/#faust-github-discussion","text":"The discussions can also take place on the Faust GitHub discussion forum .","title":"Faust GitHub discussion"},{"location":"community/ifc/","text":"International Faust Conference (IFC) The International Faust Conference (IFC) takes place every two year. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants share their work through paper presentations. A series of round tables on various topics serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops are usually available for participants to openly share their ongoing projects with the rest of the community. Next Edition: IFC-24 - November 21-22, 2024 - Before SoundMit 24 at Turin (Italy) The fourth edition of the International Faust Conference ( IFC-24 ) will take place just before SoundMit 24 on November 21-22, 2024 at Turin (Italy). Past Editions IFC-22 - June 7-8, 2022 - During SMC-22 at St-Etienne (France) The third edition of the International Faust Conference (IFC-22) took place during SMC-22 at St-Etienne (France) on June 7-8, 2022, with morning recording and afternoon recording . IFC-20 - MSH Paris Nord Saint-Denis (France) The second edition of the International Faust Conference (IFC-20) took place at the Maison des Sciences de l\u2019Homme Paris Nord on December 1-2, 2020. IFC-18 - JGU, Mainz (Germany) The first edition of the International Faust Conference (IFC-18) took place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018.","title":"Faust Conference"},{"location":"community/ifc/#international-faust-conference-ifc","text":"The International Faust Conference (IFC) takes place every two year. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants share their work through paper presentations. A series of round tables on various topics serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops are usually available for participants to openly share their ongoing projects with the rest of the community.","title":"International Faust Conference (IFC)"},{"location":"community/ifc/#next-edition-ifc-24-november-21-22-2024-before-soundmit-24-at-turin-italy","text":"The fourth edition of the International Faust Conference ( IFC-24 ) will take place just before SoundMit 24 on November 21-22, 2024 at Turin (Italy).","title":"Next Edition: IFC-24 - November 21-22, 2024 - Before SoundMit 24 at Turin (Italy)"},{"location":"community/ifc/#past-editions","text":"","title":"Past Editions"},{"location":"community/ifc/#ifc-22-june-7-8-2022-during-smc-22-at-st-etienne-france","text":"The third edition of the International Faust Conference (IFC-22) took place during SMC-22 at St-Etienne (France) on June 7-8, 2022, with morning recording and afternoon recording .","title":"IFC-22 - June 7-8, 2022 - During SMC-22 at St-Etienne (France)"},{"location":"community/ifc/#ifc-20-msh-paris-nord-saint-denis-france","text":"The second edition of the International Faust Conference (IFC-20) took place at the Maison des Sciences de l\u2019Homme Paris Nord on December 1-2, 2020.","title":"IFC-20 - MSH Paris Nord Saint-Denis (France)"},{"location":"community/ifc/#ifc-18-jgu-mainz-germany","text":"The first edition of the International Faust Conference (IFC-18) took place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018.","title":"IFC-18 - JGU, Mainz (Germany)"},{"location":"community/learning/","text":"Learning Faust Faust Kadenze Course In 2018, Yann Orlarey and Romain Michon shot an online course on the Kadenze platform on Real Time Audio Signal Processing in Faust . The videos of this course are free to watch online . Center for Computer Research in Music and Acoustics (CCRMA) Several courses on Faust are given at CCRMA: Julius Smith's Faust tutorial , Writing a Slew Limiter in the Faust Language and Make an Eight Channel Mixer in the Faust IDE Romain Michon's Faust tutorials Music 250a (Physical Interaction Design for Music) course which hosts various tutorials on Faust and hardware Music 250a 2021 and related videos Music 320c (Audio Plugin Development in Faust and C++) Embedded DSP With Faust Workshop TU Berlin The regular sound synthesis class at the Audio Communication Group, TU Berlin, makes use of Faust for exploring the basics of different synthesis algorithms. Student projects based on Faust include Eurorack modules, standalone drum machines and synthesizers, as well as data sonification approaches. The class is taught by Henrik von Coler , who is director of the Electronic Studio at the TU, with a Building Instruments in Faust course. HPI Potsdam The class Data Sonification & Opportunities of Sound at Hasso Plattner Institute, University of Potsdam Potsdam, is an interdisciplinary format, exploring the use of sonification and sound synthesis in the context of design thinking, neurosience and medical applications. The signal processing part is taught by Henrik von Coler . Universit\u00e9 Paris 8 A 24 hours introduction to Faust is given by Alain Bonardi during the first semester to undergraduated students (L3, 3rd year after the french 'baccalaur\u00e9at') in the framework of the course \"Programming Languages in Computer Music 1\" offered in the \"Music creation with computerqs\" minor. Universidad Nacional de Quilmes Cursos de Faust / DSP en espan\u0303ol, realizados por Juan Ramos . Incluyen las clases del \"Seminario de Actualizacio\u0301n en Sonido, Ciencia y Tecnologi\u0301a II\", dictado en la Universidad Nacional de Quilmes (Argentina) en 2021. Faust / DSP courses in Spanish, prepared by Juan Ramos . They include the classes of the \"Update Seminar on Sound, Science and Technology II\", held at the National University of Quilmes (Argentina) in 2021: An intro video is available here All available classes are located here Professional Masters of RIM & RAN The Professional RIM & RAN Masters are aimed at developing students applied knowledge and understanding of electronic and digital technologies for the creation, prepare them to the professions of Producer in Computer Music (RIM - R\u00e9alisateur en Informatique Musicale) and in Digital Arts (RAN - R\u00e9alisateur en Arts Num\u00e9riques) . These producers are direct actors in musical and artistic productions, and work at the interface between software developers, applied computer scientists, composers, artists, etc. and all people likely to integrate video, image and sound in their activities. Most of the courses concerning signal processing are given around the Faust language (M1 Romain Michon 12h / M2 Yann Orlarey 20h). Johannes Gutenberg University of Mainz To complete...","title":"Learning Faust"},{"location":"community/learning/#learning-faust","text":"","title":"Learning Faust"},{"location":"community/learning/#faust-kadenze-course","text":"In 2018, Yann Orlarey and Romain Michon shot an online course on the Kadenze platform on Real Time Audio Signal Processing in Faust . The videos of this course are free to watch online .","title":"Faust Kadenze Course"},{"location":"community/learning/#center-for-computer-research-in-music-and-acoustics-ccrma","text":"Several courses on Faust are given at CCRMA: Julius Smith's Faust tutorial , Writing a Slew Limiter in the Faust Language and Make an Eight Channel Mixer in the Faust IDE Romain Michon's Faust tutorials Music 250a (Physical Interaction Design for Music) course which hosts various tutorials on Faust and hardware Music 250a 2021 and related videos Music 320c (Audio Plugin Development in Faust and C++) Embedded DSP With Faust Workshop","title":"Center for Computer Research in Music and Acoustics (CCRMA)"},{"location":"community/learning/#tu-berlin","text":"The regular sound synthesis class at the Audio Communication Group, TU Berlin, makes use of Faust for exploring the basics of different synthesis algorithms. Student projects based on Faust include Eurorack modules, standalone drum machines and synthesizers, as well as data sonification approaches. The class is taught by Henrik von Coler , who is director of the Electronic Studio at the TU, with a Building Instruments in Faust course.","title":"TU Berlin"},{"location":"community/learning/#hpi-potsdam","text":"The class Data Sonification & Opportunities of Sound at Hasso Plattner Institute, University of Potsdam Potsdam, is an interdisciplinary format, exploring the use of sonification and sound synthesis in the context of design thinking, neurosience and medical applications. The signal processing part is taught by Henrik von Coler .","title":"HPI Potsdam"},{"location":"community/learning/#universite-paris-8","text":"A 24 hours introduction to Faust is given by Alain Bonardi during the first semester to undergraduated students (L3, 3rd year after the french 'baccalaur\u00e9at') in the framework of the course \"Programming Languages in Computer Music 1\" offered in the \"Music creation with computerqs\" minor.","title":"Universit\u00e9 Paris 8"},{"location":"community/learning/#universidad-nacional-de-quilmes","text":"Cursos de Faust / DSP en espan\u0303ol, realizados por Juan Ramos . Incluyen las clases del \"Seminario de Actualizacio\u0301n en Sonido, Ciencia y Tecnologi\u0301a II\", dictado en la Universidad Nacional de Quilmes (Argentina) en 2021. Faust / DSP courses in Spanish, prepared by Juan Ramos . They include the classes of the \"Update Seminar on Sound, Science and Technology II\", held at the National University of Quilmes (Argentina) in 2021: An intro video is available here All available classes are located here","title":"Universidad Nacional de Quilmes"},{"location":"community/learning/#professional-masters-of-rim-ran","text":"The Professional RIM & RAN Masters are aimed at developing students applied knowledge and understanding of electronic and digital technologies for the creation, prepare them to the professions of Producer in Computer Music (RIM - R\u00e9alisateur en Informatique Musicale) and in Digital Arts (RAN - R\u00e9alisateur en Arts Num\u00e9riques) . These producers are direct actors in musical and artistic productions, and work at the interface between software developers, applied computer scientists, composers, artists, etc. and all people likely to integrate video, image and sound in their activities. Most of the courses concerning signal processing are given around the Faust language (M1 Romain Michon 12h / M2 Yann Orlarey 20h).","title":"Professional Masters of RIM &amp; RAN"},{"location":"community/learning/#johannes-gutenberg-university-of-mainz","text":"To complete...","title":"Johannes Gutenberg University of Mainz"},{"location":"community/logos/","text":"Faust Logos The Faust logo is available in several variants (Full Logo, Simple Logo, Faust Award, and Made with Faust). The Adobe Illustrator file is available here Full Logo Very nice and trendy on your T-shirt... Blue White Grey Orange Simple Logo If you don't have too much space... Blue White Grey Orange Faust Awards And the winner is... Blue White Grey Orange Made with Faust For your next killer app... Blue White Grey Orange","title":"Logos"},{"location":"community/logos/#faust-logos","text":"The Faust logo is available in several variants (Full Logo, Simple Logo, Faust Award, and Made with Faust). The Adobe Illustrator file is available here","title":"Faust Logos"},{"location":"community/logos/#full-logo","text":"Very nice and trendy on your T-shirt...","title":"Full Logo"},{"location":"community/logos/#blue","text":"","title":"Blue"},{"location":"community/logos/#white","text":"","title":"White"},{"location":"community/logos/#grey","text":"","title":"Grey"},{"location":"community/logos/#orange","text":"","title":"Orange"},{"location":"community/logos/#simple-logo","text":"If you don't have too much space...","title":"Simple Logo"},{"location":"community/logos/#blue_1","text":"","title":"Blue"},{"location":"community/logos/#white_1","text":"","title":"White"},{"location":"community/logos/#grey_1","text":"","title":"Grey"},{"location":"community/logos/#orange_1","text":"","title":"Orange"},{"location":"community/logos/#faust-awards","text":"And the winner is...","title":"Faust Awards"},{"location":"community/logos/#blue_2","text":"","title":"Blue"},{"location":"community/logos/#white_2","text":"","title":"White"},{"location":"community/logos/#grey_2","text":"","title":"Grey"},{"location":"community/logos/#orange_2","text":"","title":"Orange"},{"location":"community/logos/#made-with-faust","text":"For your next killer app...","title":"Made with Faust"},{"location":"community/logos/#blue_3","text":"","title":"Blue"},{"location":"community/logos/#white_3","text":"","title":"White"},{"location":"community/logos/#grey_3","text":"","title":"Grey"},{"location":"community/logos/#orange_3","text":"","title":"Orange"},{"location":"community/news/","text":"Faust News 2018-07-23: Faust's Evolution View the evolution of the Faust project from 2004 to 2018. The visualization was done using Gource . Here is the command used (as suggested by fullybacked ): gource --hide dirnames,filenames --seconds-per-day 0.1 --auto-skip-seconds 1 -1920x1024 -o - | ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i - -vcodec libx264 -preset ultrafast -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 faust-hd.mp4 2018-07-23: Faust Award 2018 The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale. Faust Award 2018 to iPlug 2 The Faust Award 2018 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to iPlug 2 a free open source C++ audio plug-in framework, allowing developers to create audio plug-ins and apps across a wide range of formats from the same code, including graphical user interface and DSP components. Amongst many other new features and a reworked code base, version 2 includes support for FAUST, allowing sections of audio DSP to be implemented using the FAUST language, and easily integrated with other C++ elements. iPlug 2 is developed by Oliver Larkin and Alex Harker from the original iPlug, by Cockos inc. that was open sourced in 2008. The project is under active development and will be publicly released at the end of 2018. The jury praised the quality, the ambition, and the usefulness of iPlug 2 as a Faust development framework! Check the demo here . We hope that the Faust Award will help the authors to fully finalize the project. Faust Student Software Competition to Cloud Generator In parallel to the main competition, the Faust Student Software Competition , is intended to promote small, but innovative Faust applications, typically developed in the framework of student projects. The student prize 2018 was awarded to Cloud Generator a nine-voice polyphonic synthesizer developed by Rittik Wystup. The jury praised the audio quality and the care taken by Rittik Wystup in his project! Check the Cloud Generator demo here . 2018-07-10: IFC 2018 International Faust Conference IFC18 : July 17-18, 2018 The International Faust Conference IFC18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC18 . IFC-18 is free and everyone is welcome to attend! Please register here -- 2018-02-18: Faust Award 2018 Faust Award 2018: deadline June 1, 2018 The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools built around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 17, 2018 during the International Faust Conference in Mainz IFC18 . To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc. Junior Competition In parallel to the Faust Open-Source Software Competition we have a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count. Important dates Start of the competition: February 18, 2018 Software Submission Deadline: June 1, 2018 Results of the competition: July 17, 2018 Submission Guidelines Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition. International Committee Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA) Previous Winners 2015: Guitarix , by Hermann Meyer and Andreas Degert 2016: Ambitools , by Pierre Lecomte; Student prize: TouchVoices , by Pierre-Adrien Th\u00e9o. 2017-12-12: WebAudio wasm... WebAudio wasm benchmark pages and tools WebAudio wasm benchmark pages and tools allow to test statically generated HTML pages from Faust DSP. Audio generating pages in ScriptProcessor or AudioWorklet mode can be tested first. DSP CPU benchmark pages can be used to test the perfomance of wasm code across different browsers. Tools to generate new DSP CPU benchmark pages are also available, and finally a page allowing to test the dynamic compilation chain can be acccesed. Simple pages Simple pages can be used to test simple monophonic and polyphonic DSP, generated as ScriptProcessor or AudioWorklet WebAudio nodes. statically generated OSC as a ScriptProcessor node statically generated MIDI controllable Organ as a ScriptProcessor node Note that as 12/12/17, AudioWorklet pages can ony be tested with Chrome Canary. Be sure to activate AudioWorklet mode first. On a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7, we still hear audio glitches when testing them , for example when opening the JavaScript console, or interacting with other applications (like scrolling in the XCode editor, scrolling in the terminal...) statically generated OSC as an AudioWorlet node statically generated MIDI controllable Organ as an AudioWorlet node Polyphonic MIDI aware pages More complex statically generated polyphonic MIDI aware pages can be tested. ScriptProcessor based pages: modules/clarinetMIDI.html modules/elecGuitarMIDI.html modules/violinMIDI.html AudioWorklet based pages: modules-worklet/clarinetMIDI.html modules-worklet/elecGuitarMIDI.html modules-worklet/violinMIDI.html Benchmark pages A set of statically generated pages allow to measure the DSP CPU use of Faust generated WebAssemby code. The compute method is repeatedly called in a loop (taking 100% of a core) which duration is measured. Results as MBytes/sec as well a DSP CPU load in % of a 1024 frames, 44.1 kHz audio buffer are displayed. On the following pages, just hit the Start benchmark button, and wait for the result to be displayed. Note that since the computation is done in the main JavaScript thread, don't disturb your machine too much to get a reliable result. The pages can typically be used to compare the performances of different browsers: bench/clarinetMIDI.html bench/djembe.html bench/filterBank.html bench/freeverb.html bench/frenchBell.html bench/guitarEffectChain.html bench/karplus.html bench/karplus32.html bench/kisana.html bench/spectralLevel.html bench/stunedBar6.html bench/violinMIDI.html bench/zitaRev.html Testing the denormal issue A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. Even with the software FTZ mode, we still see huge DSP CPU issue in some cases like this djembe physical model based on simple biquad filters: modules/djembe.html On OSX for instance, open the Activity Monitor tool and look as your browser CPU use. Then hit the checkbox to start playing, and hit it again to stop it. Silence should be produced, but actually very small sample values (= subnormals) are generated. If your machine uses an Intel CPU, you will see CPU raise quite rapidly ! (tested on a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7). Benchmark tools For developers, benchmark tools allow to generate HTML pages to test your DSP. Look in particular at the faust2benchwasm script. Dynamic compilation chain testing page A more complete testing page for monophonic and polyphonic MIDI aware DSP, ScriptProcessor or AudioWorklet mode, FTZ selection mode is available here . 2017-11-07: 1st IFC 1st International Faust Conference - Johannes Gutenberg University, Mainz (Germany), July 17-18, 2018 The International Faust Conference IFC-18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC-18. IFC-18 is free and everyone is welcome to attend! Call for Papers We welcome submissions from academic, professional, independent programmers, artists, etc. We solicit original papers centered around the Faust programming language in the following categories: Original research Technology tutorial Artistic project report (e.g., installation, composition, etc.) Paper should be up to 14 pages in length, non anonymous, and formatted according to this template . Submissions should be carried out via our EasyChair portal . All submissions are subject to peer review. Acceptance may be conditional upon changes being made to the paper as directed by reviewers. Accepted papers will be published on-line as well as in the IFC-18 proceedings paper version. They will be presented by their author(s) at IFC-18 as 15 minutes presentations (+ 5 minutes for questions). Feel free to contact us if you have any question. Important Dates Papers submission deadline: March 2, 2018 Notification of Acceptance: May 1, 2018 Camera-Ready Version: June 1, 2018 Call for Round Table Topics A series of round tables on the following themes will take place both afternoons of IFC-18: Faust Tools (e.g., Architectures, IDE, Faust Code Generator, On-Line Services, etc.) DSP in Faust and Faust Libraries (e.g., New Algorithms, New Libraries, Missing Functions, etc.) Faust Compiler and Semantics Other Topics/Open Session We solicit topic suggestions from the Faust community for each of these themes. Topics can be submitted by means of this Google form . They will be introduced during the round tables by the session chair. Contact Please, address your questions to: ifc18@muwiinfa.geschichte.uni-mainz.de Conference website: http://www.ifc18.uni-mainz.de 2017-10-20: New Editor New Faust Editor We are very happy to announce the online Faust Editor . It can be used to edit , compile and run Faust code from any recent Web Browser with WebAssembly support. This editor works completely on the client side and it is therefore very convenient for situations with many simultaneous users (workshops, classrooms, etc.). It embeds the latest version of the Faust compiler with an efficient WebAssembly backend and offers polyphonic MIDI support. Features The editor engine is based on codemirror . It offers syntax highlighting , auto completion and direct access to the online documentation . The documentation command (ctrl-d) uses the function name at the cursor position to locate to the relevant information. Recommended Browsers The recommended browsers are the latest versions of Firefox and Chrome. Chrome is recommended for MIDI, but it requires an https connexion to use the audio inputs. On the other hand MIDI is not supported by Firefox. Useful links Editor : the official link, https://grame-cncm.github.io/fausteditorweb/ : an alternative link on GitHub. Because this is an https address, audio inputs will work (but not the export function), https://github.com/grame-cncm/fausteditorweb : the GitHub repository. 2017-09-15: Performances... Performances of audio DSP code compiled in WebAssembly Porting and running large C/C++ code base on the Web have been the subject of several competing projects in the recent years, from Google NaCl/PNaCl to Mozilla asm.js . Recently standardized WebAssembly language inherits from ideas experimented in both approaches, with the Mozilla vision finnally winning as Robert O'Callahan explains here . Coupled with the WebAudio API , running real-time audio code in the Web now appears to be an achievable goal. WebAssembly is a hot topic in the JavaScript ecosystem. The WebAudio community is eagerly waiting for the AudioWorklet specification, with its promised reduced latency and glitch-free audio rendering, to land in browser development versions, and be tested. Porting well established C/C++ codebase with Emscripten , like the Csound framework as an example, or using DSL languages like Faust, will then naturally beneficiate from improved and more stable performances. The Faust ecosystem already allows to generate static or dynamically compiled WebAssembly based WebAudio nodes . These nodes are still using the deprecated ScriptProcessor WebAudio interface. Premillinary work has been started to be ready as soon at the AudioWorklet model will be testable. In the meantime, work have been started using the WAVM , a standalone VM for WebAssembly, that can load both the standard binary and text wasm format, compiling it in native code using the LLVM chain (generating LLVM IR and compiling it on the fly to native code using LLVM JIT compiler), and running it at (near) native speed. Glue code to load and run Faust generated wasm modules has been written. Validation and benchmarking tools have been developed. Performances comparison with the C++ and LLVM IR Faust backends is the subject of this post. Comparing the Faust C++, LLVM IR and wast/wasm backends The WebAssembly approach promises near native performances for C/C++ written code compiled to WebAssembly using the Emscripten tool chain. Other languages like Rust (using the mir2wasm tool) experiment direct WebAssembly generation. It seems clear that as WebAssembly specification and implementation stabilize, more and more languages will directly generate wasm to be deployed in browsers. The question of the quality of code generation at each step of the compilation chain will rapidly emerge. While WebAssembly is initially designed to run on the Web, it may be deployed in non Web environnement like nodejs , or even in standalone VM like WAVM . Thus WebAssembly becomes a portable binary format that can be used in a large variety of situations. This is especially of interest for a DSL language like Faust. Faust wast/wasm backend Faust wast/wasm backend directly produce WebAssembly code from the Faust internal FIR (Faust Imperative Representation) code. Generated modules are rather light since they define a very simple ABI to be used by the loader code. Two generation models have been defined: in monophonic mode the wast/mast module internally allocates a memory block to be used for the DSP state (controllers, delays lines, waveforms...) as well as audio buffers. in polyphonic mode, the memory block will be allocated by the loader environnement. This block will typically be sized to contain all the needed voices for the polyphonic DSP. In both cases, a full description of the DSP state as a JSON string is generated in the module data segment (including memory indexes of all controllers). Loader code will get and decode this JSON description, and use whatever parts of the description it needs to run the DSP code. In particular, control memory zones (corresponding to the UI items like buttons, sliders, bargraph...) can be directly read/written by the wrapper code. Benchmark of C++, LLVM IR and wast/wasm generated code Since Faust already generates C++ or LLVM IR code, the performances of those two backends can be compared with the new wasm one. Using the WAVM C++ written machine allows to deploy the same measuring code . The first benchmark compares the speed of C++, LLVM IR and wasm backends running a set of DSP, running on a MacBook Pro 2,2 GHz Core I7 with OSX El capitan. The same 4.0 version of LLVM toolchain has been used with the three backend. C++ and LLVM IR code has been compiled with the -Ofast optimization flag, the WAVM runtime is the standard version one (without any specific audio optimization, see later): The diagrams clearly shows that the wasm code is still slower than C++ or LLVM IR code, but speed difference is not so high in most cases. Some DSP behaviours need to be understood in more details. Optimizing the WAVM runtime for audio code The WAVM runtime strictly conforms to the WebAssembly specification, thus behaving as a interesting base reference. In the audio domain, the deployed code is usually compiled with specific optimization flags. Since C++ WAVM runtime can be hacked quite easily, we did several changes into the reference implementation to gain some speed: removing the atomic flag in all load/store that are added to pass all spec WebAssembly tests. adding the equivalent of -fast-math compilation flag that have to be done at LLVM IR and JIT (= native) generation steps. and finally simplifying some mathematical operators, using their standard definition instead of the specific WAVM coded ones that strictly implement WebAssembly official semantic (see for instance the definition of f32.min/f32.max operations). Here is the diagram of DSP examples run with reference WAVM runtime, and the three specific optimizations: After generating the LLVM IR code, the WAVM runtime runs a set of LLVM IR to IR optimizations passes. It remains to be tested if adding more optimization passes (especially the auto-vectorizations ones) could help producing even better code. WebAssembly module optimization with Binaryen Binaryen is a compiler and toolchain infrastructure library for WebAssembly , written in C++. We tested the wasm-opt tool at -O3 level on Faust generated wasm modules to estimate which speedup we can expect. The following diagram shows limited gains, with no more than 5% in some of the tested cases: Float denormal handling A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Even if using software ftz is not strictly needed in our benchmark chain (since the C++ WAVM uses the ftz hardware protection mode), we can still compare the speed of the different ftz options. Here is the result of code generated with -ftz from 0 to 2: Comparing three browsers on OSX El Capitan HTML test pages were prepared to compare the performances of the three main browsers on OSX El Capitan. The DSP code is compiled with float denormal protection on (-ftz 2). The generated wasm module compute method is called repeatedly in a timed loop, using successive slices of a big allocated circular audio buffer to avoid cache effects. Here are the results: The fasted one (Chrome for now) can be compared with C++, LLVM IR, WAVM native engines, all compiled with float denormal protection on (-ftz 2): Comments and Conclusion Testing wasm JIT machines inside browsers is not an easy task. The C++ WAVM runtime revealed to be an excellent tool to compare the Faust C++, LLVM IR and wasm backend. Since its code can be easily adapted, one can estimate also what can be expected deploying wasm DSP modules in pure native environments , outside of the browser, where some audio specific optimizations may be considered. Measures done on a set of Faust DSP show that WebAssembly code still run slower than C++ or LLVM IR generated code in most cases, up to almost 66% slower in the less favorable examples. This value will typically be a bit worse when deploying in browsers, since float denormal protection code has to be used . Benchmarks in browser wasm runtime still need to be done to confirm or refine these findings. Comparing the Chrome , Firefox and WebKit browsers on OSX El Capitan shows that Chrome is currently the fastest engine in most cases, with Firefox and WebKit quite similar (with a slight plus for WebKit). Comparing the Chrome browser with native engines shows results from 4,8 times slower (filterBank.dsp), 2,8 times slower (sTunedBar6.dsp) up to much more favorable cases (karplus32.dsp). Note that filterBank.dsp example is a bit of a pathological case, since Chrome is significantly slower than Firefox and WebKit in this case, and filterBank.dsp uses a lot of pow(10, x) code that is rewritten an optimized as exp10(x) with the C++ backend path. 2017-08-18: Faust on the Web Deploying Faust DSP on the Web EDIT : we are at the Web Audio conference 2017, and it appears that the way we currently extend the ScripProcessorNode with Faust code is not the Right Way... Part of the post concerning the exposed API will probably change a bit in the near future... Using latest developments done for the Web (the new WebAssembly backends and libfaust library compiled in WebAssembly with Emscripten), statically and dynamically Faust generated WebAudio nodes can be easily produced and deployed on the Web. Deploying statically compiled Faust WebAudio nodes From a foo.dsp source file, JavaScript and the associated WebAssembly files can be produced with the following script: faust2wasm foo.dsp This will generate a foo.wasm file with the WebAssembly module as binary code, as well as a foo.js wrapper file containing the code needed to turn the Faust DSP in a fully working WebAudio node (using an extended ScriptProcessor node). The name of the Faust DSP code file is used to define the final ScriptProcessorNode constructor name. So for instance if osc.dsp file is compiled, the following faust.createosc function will be generated: /** * Create a 'monophonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createosc = function(context, buffer_size, callback) The resulting object is an extended ScriptProcessorNode, to be used as a regular node (like connected to other WebAudio nodes), but which also adds the Faust specific API as defined in the equivalent C++ generated dsp class (see the architecture/faust/dsp/dsp.h header for more technical details), as well as JavaScript more specific functions. For instance the following ones will have to be used to control the node: var paths = node.getParams(); // get the set of paths to read/write input control parameters Then knowing the path for a given parameter, the following function is used to change the parameter value: node.setParamValue(\"/Oscillator/freq\", 0.6); A full JSON description of the node with the complete UI, can be retrieved with: var json = node.getJSON(); The complete usable API is fully documented in the generated JavaScript file in the Public API to be used to control the WebAudio node section. A simple example Web page A simple Web page using the files generated by faust2wasm on the noise.dsp file can be defined with the following parts: <!-- Load 'faust2wasm' script generated .js file --> <script src=\"noise.js\"></script> A slider to control the noise volume parameter is defined with: <P> Noise volume: <input type=\"range\" oninput=\"changeVolume(event) \"min=\"0\" max=\"1\" value=\"0.5\" step=\"0.01\"/> The WebAudio context is created and the noise slide hander is defined with: var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var noise = null; // Slider handler to change the 'noise' volume function changeVolume(event) { noise.setParamValue(\"/Noise/Volume\", parseFloat(event.target.value)); } A startnoise function which creates the Faust WebAudio node is defined with: function startnoise() { // Create the Faust generated node faust.createnoise(audio_context, 1024, function (node) { noise = node; console.log(noise.getJSON()); // Print paths to be used with 'setParamValue' console.log(noise.getParams()); // Connect it to output as a regular WebAudio node noise.connect(audio_context.destination); }); } An finally the load handler is defined to activate the code: window.addEventListener(\"load\", startnoise); Look at the Noise and OSC online pages for the complete code. Note that pages loading an additional .wasm file cannot directly be loaded in Chrome. You'll have to start a local server (using the python -m SimpleHTTPServer command for instance) and access them with their http:// based URL. Generating Polyphonic WebAudio nodes Assuming that the compiled Faust DSP file is polyphonic ready , a polyphonic ready WebAudio node can be created with the -poly parameter, and will generate the following constructor for the node (where the mydsp part will be replaced by the actual DSP name): /** * Create a 'polyphonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * to be use for the voice, and allocating the number of needed voices * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode * as parameter, or null in case of error */ faust.createmydsp_poly = function(context, buffer_size, polyphony, callback) Polyphonic nodes have an extended API to be controled with MIDI messages: /** * Instantiates a new polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOn = function (channel, pitch, velocity) /** * De-instantiates a polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOff = function (channel, pitch, velocity) /** * Gently terminates all the active voices. */ allNotesOff = function () Look at the JavaScript public documentation section for the complete description. Extended control with -comb parameter The faust2wasm tool can be used with the -comb parameter to compile several DSP files and contatenate all JavaScript code in a unique resulting comb.js file (possibly to be used in -poly mode also). Generating fully working self-contained HTML pages The faust2webaudiowasm script can be used to generate a fully working self-contained HTML page, with a SVG/CSS a Graphical User Interface. From the osc.dsp Faust DSP source file, it will generate an osc.html file: faust2webaudiowasm osc.dsp Assuming that the compiled Faust DSP file is polyphonic ready, the -poly parameter can be used to generate a polyphonic MIDI controlable instrument, to be used with a MIDI application or device. The -links generates the DSP processor SVG representation, and links to the original DSP file as well as generated SVG files, so that the HTML page can possibly be deployed as a reusable Faust DSP resource. WebAssembly module optimization Assuming that you have Binaryen tools installed on your machine, the faust2wasm and faust2webaudiowasm scripts can take an additional -opt parameter to allow WebAssembly module optimization. Deploying dynamically compiled Faust WebAudio nodes Since the libfaust library is available for the Web, it becomes possible to embed the complete dynamic compilation chain in a Web page , from the Faust DSP source to the executable WebAudio node. First the following resources (located on the Faust GitHub in architecture/webaudio folder) have to be loaded in the page: <!-- Load 'libfaust' library and wrapper code --> <script src=\"libfaust-wasm.js\"></script> <script src=\"webaudio-wasm-wrapper.js\"></script> Then the two following functions are used to generate factories, creating later on monophonic or polyphonic instances (this is necessary because of the way internal WebAssembly memory is managed): /** * Create a DSP factory from source code as a string to be used to create monophonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createDSPFactory = function (code, argv, callback) /** * Create a DSP factory from source code as a string to be used to create polyphonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createPolyDSPFactory = function (code, argv, callback) The two following functions are used to generate monophonic or polyphonic Faust WebAudio nodes: /** * Create a ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createDSPInstance = function (factory, context, buffer_size, callback) /** * Create a 'polyphonic' 'ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createPolyDSPInstance = function (factory, context, buffer_size, polyphony, callback) The resulting nodes have the same API as statically compiled nodes described in the first section, so can be controlled the same way, including the polyphonic ones. Here is a code example using faust.createDSPFactory and faust.createDSPInstance : var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var dsp_code = \"import(\\\"stdfaust.lib\\\"); vol = hslider(\\\"volume [unit:dB]\\\", 0, -96, 0, 0.1) : ba.db2linear : si.smoo; freq = hslider(\\\"freq [unit:Hz]\\\", 1000, 20, 24000, 1); process = vgroup(\\\"Oscillator\\\", os.osc(freq) * vol);\"; var osc = null; var libraries_url = \"/modules/libraries/\"; function startosc() { // Prepare argv list var argv = []; argv.push(\"-ftz\"); argv.push(\"2\"); argv.push(\"-I\"); argv.push(libraries_url); // Dynamically create the Faust generated node from explicit DSP source in 'dsp_code' faust.createDSPFactory(dsp_code, argv, function (factory) { faust.createDSPInstance(factory, audio_context, 1024 function (node) { osc = node; console.log(osc.getJSON()); // Print paths to be used with 'setParamValue' console.log(osc.getParams()); // Connect it to output as a regular WebAudio node osc.connect(audio_context.destination); })}); } The Dynamic OSC page demonstrates the dynamic OSC complete code (based on the example seen before). The Dynamic Organ page demonstrates a polyphonic organ instrument, which loads a DSP from an url, and ready to be controlled with a MIDI device or application. Look at the Dynamic Faust compiler page for a more complete use-case of the dynamic compiler. Float denormal handling A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Use for example the following line to active software denormal handing when using faust2wasm tool: faust2wasm -ftz 2 foo.dsp The same for the faust2webaudiowasm tool: faust2webaudiowasm -ftz 2 foo.dsp For dynamic compilation, the -ftz v flag will have to be added in the argv parameter in faust.createDSPFactory or faust.createPolyDSPFactory , like for instance: faust.createPolyFactory(dsp_code, ['-ftz', '2'], callback); 2017-06-16: Memory allocator Using a custom memory allocator From a DSP source file, the Faust compiler typically generates a C++ class. When a rdtable item is used on the source code, the C++ class will contain a table shared by all instances of the class. By default, this table is generated as a static class array, and so allocated in the application global static memory. In some specific case (usually in more constrained deployment cases), managing where this data is allocated is crucial. By extension this post explains how a custom memory allocator can be used to precisely control the DSP memory allocation. Faust -mem option to control memory related code generation A new -mem compiler parameter has been added in the Faust compiler, starting from the 0.9.103 version (or 2.1.4 in Faust2 branch). This parameter will change the way static shared tables are generated. The table is allocated as a class static pointer allocated using a custom memory allocator , which has the following propotype: struct dsp_memory_manager { virtual ~dsp_memory_manager() {} virtual void* allocate(size_t size) = 0; virtual void destroy(void* ptr) = 0; }; Taking the following Faust DSP example: process = (waveform {10,20,30,40,50,60,70}, %(7)~+(3) : rdtable), (waveform {1.1,2.2,3.3,4.4,5.5,6.6,7.7}, %(7)~+(3) : rdtable); Here is the generated code in default mode: ... int mydsp::itbl0[7]; float mydsp::ftbl0[7]; static void classInit(int samplingFreq) { SIG0 sig0; sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; sig1.init(samplingFreq); sig1.fill(7,ftbl0); } virtual void init(int samplingFreq) { classInit(samplingFreq); instanceInit(samplingFreq); } virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are static class arrays. They are filled in the classInit method. The architecture code will typically call the init method (which calls classInit ) on a given DSP, to allocate class related arrays and the DSP itself. If several DSP are going to be allocated, calling classInit only once then the instanceInit method on each allocated DSP is the way to go. In the new -mem mode, the generated C++ code is now: ... int* mydsp::itbl0 = 0; float* mydsp::ftbl0 = 0; dsp_memory_manager* mydsp::fManager = 0; static void classInit(int samplingFreq) { SIG0 sig0; itbl0 = static_cast<int*>(fManager->allocate(sizeof(int) * 7)); sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; ftbl0 = static_cast<float*>(fManager->allocate(sizeof(float) * 7)); sig1.init(samplingFreq); sig1.fill(7,ftbl0); } static void classDestroy() { fManager->destroy(itbl0); fManager->destroy(ftbl0); } virtual void init(int samplingFreq) {} virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are generated a class static pointers. The classInit method takes the additional dsp_memory_manager object used to allocate tables. A new classDestroy method is available to deallocate the tables. Finally the init method is now empty, since the architecure file is supposed to use the classInit/classDestroy method once to allocate and deallocate static tables, and the instanceInit method on each allocated DSP. Control of the DSP memory allocation An architecture file can now define its custom memory manager by subclassing the dsp_memory_manager abstract base class, and implement the two required allocate and destroy methods. Here is an example of a simple heap allocating manager: struct malloc_memory_manager : public dsp_memory_manager { virtual void* allocate(size_t size) { void* res = malloc(size); cout << \"malloc_manager: \" << size << endl; return res; } virtual void destroy(void* ptr) { cout << \"free_manager\" << endl; free(ptr); } }; Controlling the table memory allocation To control table memory allocation, the architecture file will have to do: // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Allocate the dsp instance using regular C++ new mydsp* dsp = new mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Deallocate the dsp instance using regular C++ delete delete dsp; // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy(); Controlling the complete DSP memory allocation Full control the DSP memory allocation can be done using C++ placement new : #include <new> // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Placement new using the custom allocator mydsp* dsp = new(manager.allocate(sizeof(mydsp))) mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Calling the destructor dsp->~mydsp(); // Deallocate the pointer itself using the custom memory allocator manager.destroy(dsp); // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy(); More complex custom memory allocators can be developed by refining this malloc_memory_manager example, possibly defining real-time memory allocators...etc... The OWL architecture file already uses this new custom memory allocator model. This is a work in progress: in the Faust2 branch, this model is still not supported yet beside the C++ backend custom memory allocator is not yet supported is additional DSP classes (like the mydsp_poly defined in the achitecture/faust/dsp/poly-dsp.h header). 2017-04-26: Optimizing... Optimizing the DSP CPU usage The Faust compiler has as lot of different compilation parameters to play with. Discovering them for a given DSP program is something that can be automated. Two measure_dsp and dsp_optimizer classes are available for developers to measure DSP CPU use directly in their code. Two more friendly faustbench and faustbench-llvm tools have been developed using them. They allow to discover the best Faust compiler parameters, to be used later on with faust2xx scripts, faustgen~ Max/MSP external or FaustLive . The measure_dsp and dsp_optimizer DSP decorator classes The measure_dsp class defined in the faust/dsp/dsp-bench.h file allows to decorate a given DSP object and measure its compute method CPU consumption. Results are given in Megabytes/seconds (higher is better). Here is a C++ code example of its use: static void bench(dsp* dsp, const string& name) { // Init the DSP dsp->init(48000); // Wraps it with a 'measure_dsp' decorator measure_dsp mes(dsp, 1024, 5); // Measure the CPU use mes.measure(); // Print the stats cout << name << \" CPU use : \" << mes.getStats() << endl; } Only part of the Faust2 branch and defined in the faust/dsp/dsp-optimizer.h file, the dsp_optimizer class uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. Here is a C++ code example of its use: static void dynamic_bench(const string& dsp_source) { // Init the DSP optimizer with the dsp_source to compile // (either the filename or source code string) dsp_optimizer optimizer(dsp_source, \"/usr/local/share/faust\", \"\", 1024); double value; // Discover the best set of parameters vector<string> options = optimizer.findOptimizedParameters(value); // Print the result cout << \"Best value is for '\" << argv[1] << \"' is : \" << value << \" with \"; for (int i = 0; i < options.size(); i++) { cout << options[i] << \" \"; } cout << endl; } Using the faustbench tool The faustbench tool uses the C++ backend to generate a set of C++ files produced with different Faust compiler options. All files are then compiled in a unique binary that will measure DSP CPU of all versions of the compiled DSP. The tool is supposed to be launched in a terminal, but it can be used to generate an iOS project, ready to be launched and tested in Xcode. Here are the available options: faustbench [-ios] [Additional Faust options (-vec -vs 8...)] <file.dsp> Use '-ios' to generate an iOS project Use 'export CXX=/path/to/compiler' before running faustbench to change the C++ compiler Use 'export CXXFLAGS=options' before running faustbench to change the C++ compiler options Here is a trace of its use: faustbench karplus32.dsp Selected compiler is g++ with CXXFLAGS = -Ofast -scal : 77.5123 -vec -lv 0 -vs 4 : 64.2194 -vec -lv 0 -vs 8 : 80.8951 -vec -lv 0 -vs 16 : 106.244 ..... -vec -lv 1 -vs 128 -g : 130.635 -vec -lv 1 -vs 256 -g : 134.335 -vec -lv 1 -vs 512 -g : 135.352 Best value is : 136.235 with -vec -lv 0 -vs 512 Using the faustbench-llvm tool Available in the faust2 branch only, the faustbench-llvm tool uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. In the main Faust folder, use make bench && sudo make install to build and install the tool. Here is a trace of its use: faustbench-llvm karplus32.dsp Estimate timing parameters -scal : 21.1269 duration = 0.102801 count = 24318 Discover best parameters option -scal : 21.1034 -vec -lv 0 -vs 4 : 42.0734 -vec -lv 0 -vs 8 : 55.3725 -vec -lv 0 -vs 16 : 85.3855 ..... -vec -lv 1 -vs 128 -dfs : 133.974 -vec -lv 1 -vs 256 -dfs : 139.12 -vec -lv 1 -vs 512 -dfs : 91.8424 Refined with -mcd -vec -lv 0 -vs 256 -g -mcd 2 : 83.5555 -vec -lv 0 -vs 256 -g -mcd 4 : 138.519 -vec -lv 0 -vs 256 -g -mcd 8 : 140.122 -vec -lv 0 -vs 256 -g -mcd 16 : 141.558 -vec -lv 0 -vs 256 -g -mcd 32 : 139.454 -vec -lv 0 -vs 256 -g -mcd 64 : 143.405 -vec -lv 0 -vs 256 -g -mcd 128 : 142.975 -vec -lv 0 -vs 256 -g -mcd 256 : 139.345 Best value is for 'karplus32.dsp' is : 142.473 with -vec -lv 0 -vs 256 -dfs -mcd 64 w 2017-02-21: Faust meets JUCE JUCE is an open-source cross-platform C++ application framework, used for the development of desktop and mobile applications. JUCE is used in particular for its GUI and plugins libraries. A set of architecture files have been developed to deploy standalone or plugins built from Faust code. They allow to automatically generate the GUI from the Faust program, possibly supporting polyphonic instruments, and be controlled by MIDI or OSC messages. The architecture files are then combined to produce ready to compile JUCE applications or plugins, using tools that are part of the Faust distribution. They can also be accessed using the Faust online compiler. faust2juce script faust2juce transforms a Faust DSP program into a fully working JUCE standalone application or plugin, which can possibly be controlled with MIDI or OSC messages. Read its complete description here . You'll have to get a recent github version of Faust tree to use it. Using the online compiler The Faust online compiler has been updated to provide new 'juce' targets. Note that only some of the possible compilation options are availble for now: the application target produces a standalone MIDI controlable application (using Faust polyphonic code if the Faust source code is polyphonic aware) the plug-in target produces a MIDI controlable mono or polyphonic plugin (using Faust polyphonic code if the Faust source code is polyphonic aware) the jsynth target produces a MIDI controlable mono or polyphonic plugin (using JUCE polyphonic Synthesizer if the Faust source code is polyphonic aware) Directly using faust2juce provides the full control of the generated target with access to all possible compilation parameters. Graph of Faust generated plugins Here is an example of three Faust generated plugins running in JUCE plugin host: Using libfaust and LLVM An alternative to faust2juce static-compilation model, is to use Oliver Larkin's juce_faustllvm module, also used in his pMix2 tool . 2017-01-13: WebAssembly... Faust WebAssembly backend WebAssembly was born with the premise of creating a safe, portable and fast to load and execute format suitable for the web. WebAssembly its not a programing language but a compilation target with a text and binary specs. That means that other low level languages like C/C++, Rust, Swift, etc. can compile to WebAssembly. Specified and developed by principal browser compagnies (Google, Mozilla, Microsoft and Apple), this new format aims to finally replace the more hackish \"asm.js\" format initialy developed by Mozilla. Development versions of Chrome and Firefox can already execute it. To get an early preview of this experimental technology, at your own risk: on Chrome Canary , open chrome://flags/#enable-webassembly and enable the switch on Firefox Nightly , open about:config and set javascript.options.wasm to true See a preview of Microsoft Edge support and follow Safari support on WebKit\u2019s feature status . WebAssembly backends New WebAssembly backends have been added in the faust2 development branch. They allow to generate textual or binary WebAssembly code. 'wast' textual backend The 'wast' backend allows to generate textual WebAssembly code (in s-expression like format). Note that as of january 2017, the official textual format is not yet fully specified, thus we follow the format used in the binaryen tool . Use the following command to generate the textual output in the terminal for a given foo.dsp file. faust -lang wast foo.dsp The following command: faust -lang wast foo.dsp -o foo.wast will generate the foo.wast textual WebAssembly output file as well as an additional foo.js JavaScript file containing glue code. 'wasm' binary backend The 'wasm' backend allows to generate binary WebAssembly code. Use the following command to generate the binary output in the terminal for a given foo.dsp file. faust -lang wasm foo.dsp The following command: faust -lang wasm foo.dsp -o foo.wasm will generate the foo.wast binary WebAssembly output file as well as an additional foo.js JavaScript file containing glue code. Generating static HTML pages WebAssembly code can be feeded into WebAudio JavaScript nodes, which can then be used like any other native WebAudio node. Two scripts are available to generate static WebAudio html pages from a given foo.dsp source file with the generated html/css/svg user interface: faust2webaudiowast foo.dsp will generate the textual WebAssembly output, use binaryen wasm-as tool to convert the wast to wasm format (you'll have to compile and install the binaryen tools on your machine), and produce a self-contained html page. faust2webaudiowasm foo.dsp will generate the binary WebAssembly output that can directly be loaded by the produced self-contained html page. Page containing polyphonic instruments can be generated with the following commands: faust2webaudiowast -poly foo.dsp to use the 'wast' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument. faust2webaudiowasm -poly foo.dsp to use the 'wasm' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument. 2016-10-17: Faust Award 2016 The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale Faust Award 2016 to Ambitools The Faust Award 2016 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Dave Phillips (musician, journalist, and educator, USA) Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to Ambitools , a set of tools for real-time 3D sound field synthesis using higher order ambisonics (HOA). Ambitools is developed by Pierre Lecomte, a PhD candidate at Conservatoire National des Arts et M\u00e9tiers and Sherbrooke University. The core of the sound processing is written in Faust. The tools contain HOA encoders, decoders, binaural-filters, HOA signals transformations, spherical VU-Meter, etc. and can be compiled in various plug-ins format under Windows, Mac OSX, and Linux. The jury praised the quality and the usefulness of Ambitools: a really useful and technically advanced Faust app and an impressive technical achievement ! Check the demo . The committee was also very impressed by the quality of two other projects : Voice of Faust , a voice synthesizer/effects machine by Bart Brouns ( demo ). PMix , a graphical patcher, preset interpolator and JIT compiler for FAUST by Oliver Larkin ( demo ). Faust Student Software Competition to TouchVoices In parallel to the main competition, we introduced this year a junior competition: the Faust Student Software Competition , intended to promote small but interesting Faust applications, typically written as student projects. The student prize was awarded to TouchVoices (by Pierre-Adrien Th\u00e9o, RIM Master student at University Jean Monnet) a real-time web application allowing to capture, playback and transform sound loops. Here is a video of Pierre-Adrien Th\u00e9o during a performance with TouchVoices . A very close competitor was SuperBeatRepeater (by Vincent Rateau, of SuperDirt fame), a sample accurate beat repeater. Don't miss the demo ! 2016-08-30: FAUST book... The first FAUST book is Korean ! \u201c Sound Programming using FAUST \u201d, written by Jin-Wook Chae , an experienced audio developer and sound engineer (right) and Hyun-Hoo Jung (left), is the very first book ever published on FAUST. While the book is written in Korean, I was able to really appreciate the choice of the examples and the elegance as well as the high quality of the code. I am sure it will be an invaluable tool to promote FAUST in Korea among sound engineering, computer music students and more generally any person interested in sound programming. This book is for people desiring to produce musical instruments or sound processors. I have always been instructing my students that the ultimate importance is to discover interesting ideas about the sound. In spite of that, I have often relied on an unflattering response such as \"you may need to learn a programming language like C/C++...\" when a student asked for help with how to execute his/her ideas related to sound. Now I am pleased to recommend the use of FAUST to bring such ideas into execution. This is an easy self-study guide that can help to do just that. Now I can confidently tell anybody pursuing sound or electronic music that their exciting and brilliant idea about sound is what truly counts! So, really, how do we execute our ideas? Today I am introducing you to FAUST and to this book which you will find immensely helpful in terms of how to use FAUST to bring your fabulous ideas into reality. Jinwook Chae 2016-06-30: Faust interpreter A new 'interpreter' backend has been added in the faust2 development branch. It allows to execute Faust programs without using the LLVM dynamic compiler chain. Interpreter compilation chain The dynamic compilation chain allows developers to embed the Faust compiler technology directly in their application or plugins. Faust2 development branch uses an intermediate FIR representation (Faust Imperative Representation), which can be translated to several output languages. An LLVM backend has been previously developed to allows applications to compile a DSP source into executable code in memory, bypassing the external compiler requirement. In some specific situations, embedding the LLVM chain is not possible : for instance Apple does not allow to deploy dynamic compilers on iOS. Thus having an interpreter backend allows to get around this problem and still make Faust code run on those platforms. Interpreter backend The interpreter backend translates the FIR intermediate language into instructions for a virtual machine. A pure C++ interpreter for this instruction set has been implemented. Running and performances The interpreter backend translates the FIR intermediate language into bytecode for a virtual machine. It allows to run programs about 4 to 5 slower than native speed . Moreover this interpreter can be compiled in a special 'trace' mode to automatically detect various execution errors : invalid heap access, mathematical errors or warnings (division by zero, integer overloading....) which helps us to check the compiler semantic and code generation quality. Deployment for developers Given a Faust source code (as a file or a string), calling the createInterpreterDSPFactoryXXX function runs the compilation chain (Faust + interpreter) and generates the \u201cprototype\u201d of the class, as a interpreter-dsp-factory pointer. class interpreter_dsp_factory : public dsp_factory { public: /* Return Factory name */ std::string getName(); /* Return Factory SHA key */ std::string getSHAKey(); /* Return Factory expanded DSP code */ std::string getDSPCode(); /* Creates a new dsp instance */ dsp* createDSPInstance(); }; Note that the library keeps an internal cache of all allocated factories so that the compilation of the same DSP code, that is same source code and same set of 'normalized' (= sorted in a canonical order) compilations options, will return the same (reference counted) factory pointer. You will have to explicitly use deleteInterpreterDSPFactory to properly decrement the reference counter when the factory is no more needed. You can get a unique SHA1 key of the created factory using its getSHAKey method. Next, the createDSPInstance function, corresponding to the new className of C++, instantiates a interpreter-dsp pointer to be used through its interface, connected to the audio chain and controller interfaces. When finished, simply use delete to destroy the dsp instance. class interpreter_dsp : public dsp { public: void metadata(Meta* m); int getNumInputs(); int getNumOutputs(); void init(int samplingRate); void instanceInit(int samplingRate); dsp* clone(); void buildUserInterface(UI* inter); int getSampleRate(); void compute(int count, FAUSTFLOAT** input, FAUSTFLOAT** output); }; Since interpreter_dsp is a subclass of the dsp base class, an object of this type can be used with all already available audio and UI classes, in essence reusing all architecture files already developed for the static C++ class compilation scheme (like OSCUI, httpdUI interfaces etc.), see Developing a new architecture file . Saving/restoring the factory After the DSP factory has been compiled, your application or plugin may want to save/restore it in order to save Faust to interpreter bytecode compilation at next use. To get the internal factory compiled code, several functions are available: writeInterpreterDSPFactoryToMachine allows to get the interpreter bytecode as a string, writeInterpreterDSPFactoryToMachineFile allows to save the interpreter bytecode in a file, To re-create a DSP factory from a previously saved code, several functions are available: readInterpreterDSPFactoryFromMachine allows to create a DSP factory from a string containing the interpreter bytecode, readInterpreterDSPFactoryFromMachineFile allows to create a DSP factory from a file containing the interpreter bytecode. The complete API is available and documented in the installed faust/dsp/interpreter-dsp.h header. 2016-04-07: Web Audio API Faust and the Web Audio API (3) The Faust compiler can now directly be used in a Web page. Thanks to the Emscripten compiler, the Faust compiler itself can be compiled to asm.js JavaScript. This has been done by compiling the libfaust C++ library to the libfaust.js JavaScript library, that exports a unique entry point. Compiling DSP to JavaScript (asm.js) The libfaust.js exported function createAsmCDSPFactoryFromString(...) allows to create a DSP factory from a given DSP program as a source string and a set of compilations parameters, uses the Faust compiler asm.js backend, and produces the complete asm.js module and additional pure JavaScript methods as a string. Then calling JavaScript 'eval' function on this string compiles it in the browser. The dynamically created asm.js module and additional pure JavaScript methods can then be used. This internal code in then wrapped with additional JavaScript code. A DSP \u201cfactory\u201d will be created from the DSP source code with the following 'synchronous' code (if using the 'libfaust.js' library): var factory = faust.createDSPFactory(code, arguments); or possibly (if using the 'libfaustworker.js' library in the 'asynchronous' model): faust.createDSPFactory(code, arguments, callback); where 'code' is the DSP source as a string, and 'arguments' is an array of parameters to be given to the Faust compiler (like '-vec', '-vs 512'...), and 'callback' is a function taking the created 'factory' as argument. When no more used, you'll have to explicitly use the following code the deallocate the factory: faust.deleteDSPFactory(factory); Your application may want to save the already compiled factory as asm.js/JavaScript code to speed-up possible restore at later time: var machine_code = faust.writeDSPFactoryToMachine(factory); And restore the factory with the following code: var factory = faust.readDSPFactoryFromMachine(machine_code); Using DSP instances A fully working DSP \u201cinstance\u201d as a Web Audio node is then created with the code: var dsp = faust.createDSPInstance(factory, audio_context, buffer_size); When no more used, you'll have to explicitly use the following code to deallocate the instance: faust.deleteDSPInstance(dsp); This instance can be used like the statically compiled one, as previously described in this page . Polyphonic instruments Polyphonic instruments can be produced. For a given 'factory' the following code will create a 16 voices polyphonic instance: var dsp = faust.createPolyDSPInstance(factory, audio_context, buffer_size, 16); This instance can be used like the statically compiled one, as previously described in this page . Using Faust JavaScript library The Emscripten compiled Faust library can be used in two ways. Either using the 'libfaust.js' library: <script src=\"libfaust.js\"></script> <script src=\"webaudio-asm-wrapper.js\"></script> or if using worker mode with the following code which loads the 'libfaustworker.js' library: <script src=\"webaudio/webaudio-asm-worker-wrapper.js\"></script> 2016-02-05: Faust Award 2016 Faust Award 2016: deadline June 1, 2016 The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools build around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 15, 2016. To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc. Junior Competition In parallel to the Faust Open-Source Software Competition we introduce this year a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count. Important dates Start of the competition: February 8, 2016 Software Submission Deadline: June 1, 2016 Results of the competition: July 1, 2016 Submission Guidelines Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition. International Committee Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Dave Phillips (Musician/Journalist, Findlay, USA) Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA) Previous Winners 2015: Guitarix , by Hermann Meyer and Andreas Degert","title":"News up to 2018"},{"location":"community/news/#faust-news","text":"","title":"Faust News"},{"location":"community/news/#2018-07-23-fausts-evolution","text":"View the evolution of the Faust project from 2004 to 2018. The visualization was done using Gource . Here is the command used (as suggested by fullybacked ): gource --hide dirnames,filenames --seconds-per-day 0.1 --auto-skip-seconds 1 -1920x1024 -o - | ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i - -vcodec libx264 -preset ultrafast -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 faust-hd.mp4","title":"2018-07-23: Faust's Evolution"},{"location":"community/news/#2018-07-23-faust-award-2018","text":"The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale.","title":"2018-07-23: Faust Award 2018"},{"location":"community/news/#faust-award-2018-to-iplug-2","text":"The Faust Award 2018 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to iPlug 2 a free open source C++ audio plug-in framework, allowing developers to create audio plug-ins and apps across a wide range of formats from the same code, including graphical user interface and DSP components. Amongst many other new features and a reworked code base, version 2 includes support for FAUST, allowing sections of audio DSP to be implemented using the FAUST language, and easily integrated with other C++ elements. iPlug 2 is developed by Oliver Larkin and Alex Harker from the original iPlug, by Cockos inc. that was open sourced in 2008. The project is under active development and will be publicly released at the end of 2018. The jury praised the quality, the ambition, and the usefulness of iPlug 2 as a Faust development framework! Check the demo here . We hope that the Faust Award will help the authors to fully finalize the project.","title":"Faust Award 2018 to iPlug 2"},{"location":"community/news/#faust-student-software-competition-to-cloud-generator","text":"In parallel to the main competition, the Faust Student Software Competition , is intended to promote small, but innovative Faust applications, typically developed in the framework of student projects. The student prize 2018 was awarded to Cloud Generator a nine-voice polyphonic synthesizer developed by Rittik Wystup. The jury praised the audio quality and the care taken by Rittik Wystup in his project! Check the Cloud Generator demo here .","title":"Faust Student Software Competition to Cloud Generator"},{"location":"community/news/#2018-07-10-ifc-2018","text":"","title":"2018-07-10: IFC 2018"},{"location":"community/news/#international-faust-conference-ifc18-july-17-18-2018","text":"The International Faust Conference IFC18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC18 . IFC-18 is free and everyone is welcome to attend! Please register here --","title":"International Faust Conference IFC18: July 17-18, 2018"},{"location":"community/news/#2018-02-18-faust-award-2018","text":"","title":"2018-02-18: Faust Award 2018"},{"location":"community/news/#faust-award-2018-deadline-june-1-2018","text":"The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools built around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 17, 2018 during the International Faust Conference in Mainz IFC18 . To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc.","title":"Faust Award 2018: deadline June 1, 2018"},{"location":"community/news/#junior-competition","text":"In parallel to the Faust Open-Source Software Competition we have a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count.","title":"Junior Competition"},{"location":"community/news/#important-dates","text":"Start of the competition: February 18, 2018 Software Submission Deadline: June 1, 2018 Results of the competition: July 17, 2018","title":"Important dates"},{"location":"community/news/#submission-guidelines","text":"Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition.","title":"Submission Guidelines"},{"location":"community/news/#international-committee","text":"Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA)","title":"International Committee"},{"location":"community/news/#previous-winners","text":"2015: Guitarix , by Hermann Meyer and Andreas Degert 2016: Ambitools , by Pierre Lecomte; Student prize: TouchVoices , by Pierre-Adrien Th\u00e9o.","title":"Previous Winners"},{"location":"community/news/#2017-12-12-webaudio-wasm","text":"","title":"2017-12-12: WebAudio wasm..."},{"location":"community/news/#webaudio-wasm-benchmark-pages-and-tools","text":"WebAudio wasm benchmark pages and tools allow to test statically generated HTML pages from Faust DSP. Audio generating pages in ScriptProcessor or AudioWorklet mode can be tested first. DSP CPU benchmark pages can be used to test the perfomance of wasm code across different browsers. Tools to generate new DSP CPU benchmark pages are also available, and finally a page allowing to test the dynamic compilation chain can be acccesed.","title":"WebAudio wasm benchmark pages and tools"},{"location":"community/news/#simple-pages","text":"Simple pages can be used to test simple monophonic and polyphonic DSP, generated as ScriptProcessor or AudioWorklet WebAudio nodes. statically generated OSC as a ScriptProcessor node statically generated MIDI controllable Organ as a ScriptProcessor node Note that as 12/12/17, AudioWorklet pages can ony be tested with Chrome Canary. Be sure to activate AudioWorklet mode first. On a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7, we still hear audio glitches when testing them , for example when opening the JavaScript console, or interacting with other applications (like scrolling in the XCode editor, scrolling in the terminal...) statically generated OSC as an AudioWorlet node statically generated MIDI controllable Organ as an AudioWorlet node","title":"Simple pages"},{"location":"community/news/#polyphonic-midi-aware-pages","text":"More complex statically generated polyphonic MIDI aware pages can be tested. ScriptProcessor based pages: modules/clarinetMIDI.html modules/elecGuitarMIDI.html modules/violinMIDI.html AudioWorklet based pages: modules-worklet/clarinetMIDI.html modules-worklet/elecGuitarMIDI.html modules-worklet/violinMIDI.html","title":"Polyphonic MIDI aware pages"},{"location":"community/news/#benchmark-pages","text":"A set of statically generated pages allow to measure the DSP CPU use of Faust generated WebAssemby code. The compute method is repeatedly called in a loop (taking 100% of a core) which duration is measured. Results as MBytes/sec as well a DSP CPU load in % of a 1024 frames, 44.1 kHz audio buffer are displayed. On the following pages, just hit the Start benchmark button, and wait for the result to be displayed. Note that since the computation is done in the main JavaScript thread, don't disturb your machine too much to get a reliable result. The pages can typically be used to compare the performances of different browsers: bench/clarinetMIDI.html bench/djembe.html bench/filterBank.html bench/freeverb.html bench/frenchBell.html bench/guitarEffectChain.html bench/karplus.html bench/karplus32.html bench/kisana.html bench/spectralLevel.html bench/stunedBar6.html bench/violinMIDI.html bench/zitaRev.html","title":"Benchmark pages"},{"location":"community/news/#testing-the-denormal-issue","text":"A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. Even with the software FTZ mode, we still see huge DSP CPU issue in some cases like this djembe physical model based on simple biquad filters: modules/djembe.html On OSX for instance, open the Activity Monitor tool and look as your browser CPU use. Then hit the checkbox to start playing, and hit it again to stop it. Silence should be produced, but actually very small sample values (= subnormals) are generated. If your machine uses an Intel CPU, you will see CPU raise quite rapidly ! (tested on a MacBook Pro OSX El Capitan 2,2 GHz Intel Core i7).","title":"Testing the denormal issue"},{"location":"community/news/#benchmark-tools","text":"For developers, benchmark tools allow to generate HTML pages to test your DSP. Look in particular at the faust2benchwasm script.","title":"Benchmark tools"},{"location":"community/news/#dynamic-compilation-chain-testing-page","text":"A more complete testing page for monophonic and polyphonic MIDI aware DSP, ScriptProcessor or AudioWorklet mode, FTZ selection mode is available here .","title":"Dynamic compilation chain testing page"},{"location":"community/news/#2017-11-07-1st-ifc","text":"","title":"2017-11-07: 1st IFC"},{"location":"community/news/#1st-international-faust-conference-johannes-gutenberg-university-mainz-germany-july-17-18-2018","text":"The International Faust Conference IFC-18 will take place at the Johannes Gutenberg University of Mainz (Germany) on July 17-18, 2018. It aims at gathering developers and users of the Faust programming language to present current projects and discuss future directions for Faust and its community. Participants will be able to share their work through paper presentations. A series of round tables on various topics will serve as a platform to brainstorm on Faust's features, semantics, tools, applications, etc. to determine future directions for this language. Open spaces for demos and workshops will be available for participants to openly share their ongoing projects with the rest of the community. As a special event, the winner of GRAME's Faust Open-Source Software Competition will be announced during IFC-18. IFC-18 is free and everyone is welcome to attend!","title":"1st International Faust Conference - Johannes Gutenberg University, Mainz (Germany), July 17-18, 2018"},{"location":"community/news/#call-for-papers","text":"We welcome submissions from academic, professional, independent programmers, artists, etc. We solicit original papers centered around the Faust programming language in the following categories: Original research Technology tutorial Artistic project report (e.g., installation, composition, etc.) Paper should be up to 14 pages in length, non anonymous, and formatted according to this template . Submissions should be carried out via our EasyChair portal . All submissions are subject to peer review. Acceptance may be conditional upon changes being made to the paper as directed by reviewers. Accepted papers will be published on-line as well as in the IFC-18 proceedings paper version. They will be presented by their author(s) at IFC-18 as 15 minutes presentations (+ 5 minutes for questions). Feel free to contact us if you have any question.","title":"Call for Papers"},{"location":"community/news/#important-dates_1","text":"Papers submission deadline: March 2, 2018 Notification of Acceptance: May 1, 2018 Camera-Ready Version: June 1, 2018","title":"Important Dates"},{"location":"community/news/#call-for-round-table-topics","text":"A series of round tables on the following themes will take place both afternoons of IFC-18: Faust Tools (e.g., Architectures, IDE, Faust Code Generator, On-Line Services, etc.) DSP in Faust and Faust Libraries (e.g., New Algorithms, New Libraries, Missing Functions, etc.) Faust Compiler and Semantics Other Topics/Open Session We solicit topic suggestions from the Faust community for each of these themes. Topics can be submitted by means of this Google form . They will be introduced during the round tables by the session chair.","title":"Call for Round Table Topics"},{"location":"community/news/#contact","text":"Please, address your questions to: ifc18@muwiinfa.geschichte.uni-mainz.de Conference website: http://www.ifc18.uni-mainz.de","title":"Contact"},{"location":"community/news/#2017-10-20-new-editor","text":"","title":"2017-10-20: New Editor"},{"location":"community/news/#new-faust-editor","text":"We are very happy to announce the online Faust Editor . It can be used to edit , compile and run Faust code from any recent Web Browser with WebAssembly support. This editor works completely on the client side and it is therefore very convenient for situations with many simultaneous users (workshops, classrooms, etc.). It embeds the latest version of the Faust compiler with an efficient WebAssembly backend and offers polyphonic MIDI support.","title":"New Faust Editor"},{"location":"community/news/#features","text":"The editor engine is based on codemirror . It offers syntax highlighting , auto completion and direct access to the online documentation . The documentation command (ctrl-d) uses the function name at the cursor position to locate to the relevant information.","title":"Features"},{"location":"community/news/#recommended-browsers","text":"The recommended browsers are the latest versions of Firefox and Chrome. Chrome is recommended for MIDI, but it requires an https connexion to use the audio inputs. On the other hand MIDI is not supported by Firefox.","title":"Recommended Browsers"},{"location":"community/news/#useful-links","text":"Editor : the official link, https://grame-cncm.github.io/fausteditorweb/ : an alternative link on GitHub. Because this is an https address, audio inputs will work (but not the export function), https://github.com/grame-cncm/fausteditorweb : the GitHub repository.","title":"Useful links"},{"location":"community/news/#2017-09-15-performances","text":"","title":"2017-09-15: Performances..."},{"location":"community/news/#performances-of-audio-dsp-code-compiled-in-webassembly","text":"Porting and running large C/C++ code base on the Web have been the subject of several competing projects in the recent years, from Google NaCl/PNaCl to Mozilla asm.js . Recently standardized WebAssembly language inherits from ideas experimented in both approaches, with the Mozilla vision finnally winning as Robert O'Callahan explains here . Coupled with the WebAudio API , running real-time audio code in the Web now appears to be an achievable goal. WebAssembly is a hot topic in the JavaScript ecosystem. The WebAudio community is eagerly waiting for the AudioWorklet specification, with its promised reduced latency and glitch-free audio rendering, to land in browser development versions, and be tested. Porting well established C/C++ codebase with Emscripten , like the Csound framework as an example, or using DSL languages like Faust, will then naturally beneficiate from improved and more stable performances. The Faust ecosystem already allows to generate static or dynamically compiled WebAssembly based WebAudio nodes . These nodes are still using the deprecated ScriptProcessor WebAudio interface. Premillinary work has been started to be ready as soon at the AudioWorklet model will be testable. In the meantime, work have been started using the WAVM , a standalone VM for WebAssembly, that can load both the standard binary and text wasm format, compiling it in native code using the LLVM chain (generating LLVM IR and compiling it on the fly to native code using LLVM JIT compiler), and running it at (near) native speed. Glue code to load and run Faust generated wasm modules has been written. Validation and benchmarking tools have been developed. Performances comparison with the C++ and LLVM IR Faust backends is the subject of this post.","title":"Performances of audio DSP code compiled in WebAssembly"},{"location":"community/news/#comparing-the-faust-c-llvm-ir-and-wastwasm-backends","text":"The WebAssembly approach promises near native performances for C/C++ written code compiled to WebAssembly using the Emscripten tool chain. Other languages like Rust (using the mir2wasm tool) experiment direct WebAssembly generation. It seems clear that as WebAssembly specification and implementation stabilize, more and more languages will directly generate wasm to be deployed in browsers. The question of the quality of code generation at each step of the compilation chain will rapidly emerge. While WebAssembly is initially designed to run on the Web, it may be deployed in non Web environnement like nodejs , or even in standalone VM like WAVM . Thus WebAssembly becomes a portable binary format that can be used in a large variety of situations. This is especially of interest for a DSL language like Faust.","title":"Comparing the Faust C++, LLVM IR and wast/wasm backends"},{"location":"community/news/#faust-wastwasm-backend","text":"Faust wast/wasm backend directly produce WebAssembly code from the Faust internal FIR (Faust Imperative Representation) code. Generated modules are rather light since they define a very simple ABI to be used by the loader code. Two generation models have been defined: in monophonic mode the wast/mast module internally allocates a memory block to be used for the DSP state (controllers, delays lines, waveforms...) as well as audio buffers. in polyphonic mode, the memory block will be allocated by the loader environnement. This block will typically be sized to contain all the needed voices for the polyphonic DSP. In both cases, a full description of the DSP state as a JSON string is generated in the module data segment (including memory indexes of all controllers). Loader code will get and decode this JSON description, and use whatever parts of the description it needs to run the DSP code. In particular, control memory zones (corresponding to the UI items like buttons, sliders, bargraph...) can be directly read/written by the wrapper code.","title":"Faust wast/wasm backend"},{"location":"community/news/#benchmark-of-c-llvm-ir-and-wastwasm-generated-code","text":"Since Faust already generates C++ or LLVM IR code, the performances of those two backends can be compared with the new wasm one. Using the WAVM C++ written machine allows to deploy the same measuring code . The first benchmark compares the speed of C++, LLVM IR and wasm backends running a set of DSP, running on a MacBook Pro 2,2 GHz Core I7 with OSX El capitan. The same 4.0 version of LLVM toolchain has been used with the three backend. C++ and LLVM IR code has been compiled with the -Ofast optimization flag, the WAVM runtime is the standard version one (without any specific audio optimization, see later): The diagrams clearly shows that the wasm code is still slower than C++ or LLVM IR code, but speed difference is not so high in most cases. Some DSP behaviours need to be understood in more details.","title":"Benchmark of C++, LLVM IR and wast/wasm generated code"},{"location":"community/news/#optimizing-the-wavm-runtime-for-audio-code","text":"The WAVM runtime strictly conforms to the WebAssembly specification, thus behaving as a interesting base reference. In the audio domain, the deployed code is usually compiled with specific optimization flags. Since C++ WAVM runtime can be hacked quite easily, we did several changes into the reference implementation to gain some speed: removing the atomic flag in all load/store that are added to pass all spec WebAssembly tests. adding the equivalent of -fast-math compilation flag that have to be done at LLVM IR and JIT (= native) generation steps. and finally simplifying some mathematical operators, using their standard definition instead of the specific WAVM coded ones that strictly implement WebAssembly official semantic (see for instance the definition of f32.min/f32.max operations). Here is the diagram of DSP examples run with reference WAVM runtime, and the three specific optimizations: After generating the LLVM IR code, the WAVM runtime runs a set of LLVM IR to IR optimizations passes. It remains to be tested if adding more optimization passes (especially the auto-vectorizations ones) could help producing even better code.","title":"Optimizing the WAVM runtime for audio code"},{"location":"community/news/#webassembly-module-optimization-with-binaryen","text":"Binaryen is a compiler and toolchain infrastructure library for WebAssembly , written in C++. We tested the wasm-opt tool at -O3 level on Faust generated wasm modules to estimate which speedup we can expect. The following diagram shows limited gains, with no more than 5% in some of the tested cases:","title":"WebAssembly module optimization with Binaryen"},{"location":"community/news/#float-denormal-handling","text":"A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Even if using software ftz is not strictly needed in our benchmark chain (since the C++ WAVM uses the ftz hardware protection mode), we can still compare the speed of the different ftz options. Here is the result of code generated with -ftz from 0 to 2:","title":"Float denormal handling"},{"location":"community/news/#comparing-three-browsers-on-osx-el-capitan","text":"HTML test pages were prepared to compare the performances of the three main browsers on OSX El Capitan. The DSP code is compiled with float denormal protection on (-ftz 2). The generated wasm module compute method is called repeatedly in a timed loop, using successive slices of a big allocated circular audio buffer to avoid cache effects. Here are the results: The fasted one (Chrome for now) can be compared with C++, LLVM IR, WAVM native engines, all compiled with float denormal protection on (-ftz 2):","title":"Comparing three browsers on OSX El Capitan"},{"location":"community/news/#comments-and-conclusion","text":"Testing wasm JIT machines inside browsers is not an easy task. The C++ WAVM runtime revealed to be an excellent tool to compare the Faust C++, LLVM IR and wasm backend. Since its code can be easily adapted, one can estimate also what can be expected deploying wasm DSP modules in pure native environments , outside of the browser, where some audio specific optimizations may be considered. Measures done on a set of Faust DSP show that WebAssembly code still run slower than C++ or LLVM IR generated code in most cases, up to almost 66% slower in the less favorable examples. This value will typically be a bit worse when deploying in browsers, since float denormal protection code has to be used . Benchmarks in browser wasm runtime still need to be done to confirm or refine these findings. Comparing the Chrome , Firefox and WebKit browsers on OSX El Capitan shows that Chrome is currently the fastest engine in most cases, with Firefox and WebKit quite similar (with a slight plus for WebKit). Comparing the Chrome browser with native engines shows results from 4,8 times slower (filterBank.dsp), 2,8 times slower (sTunedBar6.dsp) up to much more favorable cases (karplus32.dsp). Note that filterBank.dsp example is a bit of a pathological case, since Chrome is significantly slower than Firefox and WebKit in this case, and filterBank.dsp uses a lot of pow(10, x) code that is rewritten an optimized as exp10(x) with the C++ backend path.","title":"Comments and Conclusion"},{"location":"community/news/#2017-08-18-faust-on-the-web","text":"","title":"2017-08-18: Faust on the Web"},{"location":"community/news/#deploying-faust-dsp-on-the-web","text":"EDIT : we are at the Web Audio conference 2017, and it appears that the way we currently extend the ScripProcessorNode with Faust code is not the Right Way... Part of the post concerning the exposed API will probably change a bit in the near future... Using latest developments done for the Web (the new WebAssembly backends and libfaust library compiled in WebAssembly with Emscripten), statically and dynamically Faust generated WebAudio nodes can be easily produced and deployed on the Web.","title":"Deploying Faust DSP on the Web"},{"location":"community/news/#deploying-statically-compiled-faust-webaudio-nodes","text":"From a foo.dsp source file, JavaScript and the associated WebAssembly files can be produced with the following script: faust2wasm foo.dsp This will generate a foo.wasm file with the WebAssembly module as binary code, as well as a foo.js wrapper file containing the code needed to turn the Faust DSP in a fully working WebAudio node (using an extended ScriptProcessor node). The name of the Faust DSP code file is used to define the final ScriptProcessorNode constructor name. So for instance if osc.dsp file is compiled, the following faust.createosc function will be generated: /** * Create a 'monophonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createosc = function(context, buffer_size, callback) The resulting object is an extended ScriptProcessorNode, to be used as a regular node (like connected to other WebAudio nodes), but which also adds the Faust specific API as defined in the equivalent C++ generated dsp class (see the architecture/faust/dsp/dsp.h header for more technical details), as well as JavaScript more specific functions. For instance the following ones will have to be used to control the node: var paths = node.getParams(); // get the set of paths to read/write input control parameters Then knowing the path for a given parameter, the following function is used to change the parameter value: node.setParamValue(\"/Oscillator/freq\", 0.6); A full JSON description of the node with the complete UI, can be retrieved with: var json = node.getJSON(); The complete usable API is fully documented in the generated JavaScript file in the Public API to be used to control the WebAudio node section.","title":"Deploying statically compiled Faust WebAudio nodes"},{"location":"community/news/#a-simple-example-web-page","text":"A simple Web page using the files generated by faust2wasm on the noise.dsp file can be defined with the following parts: <!-- Load 'faust2wasm' script generated .js file --> <script src=\"noise.js\"></script> A slider to control the noise volume parameter is defined with: <P> Noise volume: <input type=\"range\" oninput=\"changeVolume(event) \"min=\"0\" max=\"1\" value=\"0.5\" step=\"0.01\"/> The WebAudio context is created and the noise slide hander is defined with: var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var noise = null; // Slider handler to change the 'noise' volume function changeVolume(event) { noise.setParamValue(\"/Noise/Volume\", parseFloat(event.target.value)); } A startnoise function which creates the Faust WebAudio node is defined with: function startnoise() { // Create the Faust generated node faust.createnoise(audio_context, 1024, function (node) { noise = node; console.log(noise.getJSON()); // Print paths to be used with 'setParamValue' console.log(noise.getParams()); // Connect it to output as a regular WebAudio node noise.connect(audio_context.destination); }); } An finally the load handler is defined to activate the code: window.addEventListener(\"load\", startnoise); Look at the Noise and OSC online pages for the complete code. Note that pages loading an additional .wasm file cannot directly be loaded in Chrome. You'll have to start a local server (using the python -m SimpleHTTPServer command for instance) and access them with their http:// based URL.","title":"A simple example Web page"},{"location":"community/news/#generating-polyphonic-webaudio-nodes","text":"Assuming that the compiled Faust DSP file is polyphonic ready , a polyphonic ready WebAudio node can be created with the -poly parameter, and will generate the following constructor for the node (where the mydsp part will be replaced by the actual DSP name): /** * Create a 'polyphonic' ScriptProcessorNode Web Audio object * by loading and compiling the Faust wasm file * to be use for the voice, and allocating the number of needed voices * * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode * as parameter, or null in case of error */ faust.createmydsp_poly = function(context, buffer_size, polyphony, callback) Polyphonic nodes have an extended API to be controled with MIDI messages: /** * Instantiates a new polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOn = function (channel, pitch, velocity) /** * De-instantiates a polyphonic voice. * * @param channel - the MIDI channel (0..15, not used for now) * @param pitch - the MIDI pitch (0..127) * @param velocity - the MIDI velocity (0..127) */ keyOff = function (channel, pitch, velocity) /** * Gently terminates all the active voices. */ allNotesOff = function () Look at the JavaScript public documentation section for the complete description.","title":"Generating Polyphonic WebAudio nodes"},{"location":"community/news/#extended-control-with-comb-parameter","text":"The faust2wasm tool can be used with the -comb parameter to compile several DSP files and contatenate all JavaScript code in a unique resulting comb.js file (possibly to be used in -poly mode also).","title":"Extended control with -comb parameter"},{"location":"community/news/#generating-fully-working-self-contained-html-pages","text":"The faust2webaudiowasm script can be used to generate a fully working self-contained HTML page, with a SVG/CSS a Graphical User Interface. From the osc.dsp Faust DSP source file, it will generate an osc.html file: faust2webaudiowasm osc.dsp Assuming that the compiled Faust DSP file is polyphonic ready, the -poly parameter can be used to generate a polyphonic MIDI controlable instrument, to be used with a MIDI application or device. The -links generates the DSP processor SVG representation, and links to the original DSP file as well as generated SVG files, so that the HTML page can possibly be deployed as a reusable Faust DSP resource.","title":"Generating fully working self-contained HTML pages"},{"location":"community/news/#webassembly-module-optimization","text":"Assuming that you have Binaryen tools installed on your machine, the faust2wasm and faust2webaudiowasm scripts can take an additional -opt parameter to allow WebAssembly module optimization.","title":"WebAssembly module optimization"},{"location":"community/news/#deploying-dynamically-compiled-faust-webaudio-nodes","text":"Since the libfaust library is available for the Web, it becomes possible to embed the complete dynamic compilation chain in a Web page , from the Faust DSP source to the executable WebAudio node. First the following resources (located on the Faust GitHub in architecture/webaudio folder) have to be loaded in the page: <!-- Load 'libfaust' library and wrapper code --> <script src=\"libfaust-wasm.js\"></script> <script src=\"webaudio-wasm-wrapper.js\"></script> Then the two following functions are used to generate factories, creating later on monophonic or polyphonic instances (this is necessary because of the way internal WebAssembly memory is managed): /** * Create a DSP factory from source code as a string to be used to create monophonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createDSPFactory = function (code, argv, callback) /** * Create a DSP factory from source code as a string to be used to create polyphonic DSP * * @param code - the source code as a string * @param argv - an array of parameters to be given to the Faust compiler * @param callback - a callback taking the created DSP factory as parameter, * or null in case of error */ faust.createPolyDSPFactory = function (code, argv, callback) The two following functions are used to generate monophonic or polyphonic Faust WebAudio nodes: /** * Create a ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createDSPInstance = function (factory, context, buffer_size, callback) /** * Create a 'polyphonic' 'ScriptProcessorNode Web Audio object from a factory * * @param factory - the DSP factory * @param context - the Web Audio context * @param buffer_size - the buffer_size in frames * @param polyphony - the number of polyphonic voices * @param callback - a callback taking the created ScriptProcessorNode as parameter, * or null in case of error */ faust.createPolyDSPInstance = function (factory, context, buffer_size, polyphony, callback) The resulting nodes have the same API as statically compiled nodes described in the first section, so can be controlled the same way, including the polyphonic ones. Here is a code example using faust.createDSPFactory and faust.createDSPInstance : var isWebKitAudio = (typeof (webkitAudioContext) !== \"undefined\"); var audio_context = (isWebKitAudio) ? new webkitAudioContext() : new AudioContext(); var dsp_code = \"import(\\\"stdfaust.lib\\\"); vol = hslider(\\\"volume [unit:dB]\\\", 0, -96, 0, 0.1) : ba.db2linear : si.smoo; freq = hslider(\\\"freq [unit:Hz]\\\", 1000, 20, 24000, 1); process = vgroup(\\\"Oscillator\\\", os.osc(freq) * vol);\"; var osc = null; var libraries_url = \"/modules/libraries/\"; function startosc() { // Prepare argv list var argv = []; argv.push(\"-ftz\"); argv.push(\"2\"); argv.push(\"-I\"); argv.push(libraries_url); // Dynamically create the Faust generated node from explicit DSP source in 'dsp_code' faust.createDSPFactory(dsp_code, argv, function (factory) { faust.createDSPInstance(factory, audio_context, 1024 function (node) { osc = node; console.log(osc.getJSON()); // Print paths to be used with 'setParamValue' console.log(osc.getParams()); // Connect it to output as a regular WebAudio node osc.connect(audio_context.destination); })}); } The Dynamic OSC page demonstrates the dynamic OSC complete code (based on the example seen before). The Dynamic Organ page demonstrates a polyphonic organ instrument, which loads a DSP from an url, and ready to be controlled with a MIDI device or application. Look at the Dynamic Faust compiler page for a more complete use-case of the dynamic compiler.","title":"Deploying dynamically compiled Faust WebAudio nodes"},{"location":"community/news/#float-denormal-handling_1","text":"A specific problem occurs when audio computation produces denormal float values, which is quite common with recursive filters, and can be extremely costly to compute on some processors like the Intel family for instance. A Flush To Zero (FTZ) mode for denormals can usually be set at hardware level, but it not yet available in the WebAssembly MVP version, which strictly conform to the IEEE 754 norm 8. Thus an automatic software strategy which consists in adding FTZ code in all recursive loops has been implemented in the Faust compiler. To activate it, the -ftz compilation parameter must be used at compilation time. The -ftz 1 mode adds a test in each recursive loop which uses the fabs function and a threshold to detect subnormal samples (slower). The -ftz 2 mode adds a test in each recursive loop which uses a mask to detect subnormal samples (faster). Use for example the following line to active software denormal handing when using faust2wasm tool: faust2wasm -ftz 2 foo.dsp The same for the faust2webaudiowasm tool: faust2webaudiowasm -ftz 2 foo.dsp For dynamic compilation, the -ftz v flag will have to be added in the argv parameter in faust.createDSPFactory or faust.createPolyDSPFactory , like for instance: faust.createPolyFactory(dsp_code, ['-ftz', '2'], callback);","title":"Float denormal handling"},{"location":"community/news/#2017-06-16-memory-allocator","text":"","title":"2017-06-16: Memory allocator"},{"location":"community/news/#using-a-custom-memory-allocator","text":"From a DSP source file, the Faust compiler typically generates a C++ class. When a rdtable item is used on the source code, the C++ class will contain a table shared by all instances of the class. By default, this table is generated as a static class array, and so allocated in the application global static memory. In some specific case (usually in more constrained deployment cases), managing where this data is allocated is crucial. By extension this post explains how a custom memory allocator can be used to precisely control the DSP memory allocation.","title":"Using a custom memory allocator"},{"location":"community/news/#faust-mem-option-to-control-memory-related-code-generation","text":"A new -mem compiler parameter has been added in the Faust compiler, starting from the 0.9.103 version (or 2.1.4 in Faust2 branch). This parameter will change the way static shared tables are generated. The table is allocated as a class static pointer allocated using a custom memory allocator , which has the following propotype: struct dsp_memory_manager { virtual ~dsp_memory_manager() {} virtual void* allocate(size_t size) = 0; virtual void destroy(void* ptr) = 0; }; Taking the following Faust DSP example: process = (waveform {10,20,30,40,50,60,70}, %(7)~+(3) : rdtable), (waveform {1.1,2.2,3.3,4.4,5.5,6.6,7.7}, %(7)~+(3) : rdtable); Here is the generated code in default mode: ... int mydsp::itbl0[7]; float mydsp::ftbl0[7]; static void classInit(int samplingFreq) { SIG0 sig0; sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; sig1.init(samplingFreq); sig1.fill(7,ftbl0); } virtual void init(int samplingFreq) { classInit(samplingFreq); instanceInit(samplingFreq); } virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are static class arrays. They are filled in the classInit method. The architecture code will typically call the init method (which calls classInit ) on a given DSP, to allocate class related arrays and the DSP itself. If several DSP are going to be allocated, calling classInit only once then the instanceInit method on each allocated DSP is the way to go. In the new -mem mode, the generated C++ code is now: ... int* mydsp::itbl0 = 0; float* mydsp::ftbl0 = 0; dsp_memory_manager* mydsp::fManager = 0; static void classInit(int samplingFreq) { SIG0 sig0; itbl0 = static_cast<int*>(fManager->allocate(sizeof(int) * 7)); sig0.init(samplingFreq); sig0.fill(7,itbl0); SIG1 sig1; ftbl0 = static_cast<float*>(fManager->allocate(sizeof(float) * 7)); sig1.init(samplingFreq); sig1.fill(7,ftbl0); } static void classDestroy() { fManager->destroy(itbl0); fManager->destroy(ftbl0); } virtual void init(int samplingFreq) {} virtual void instanceInit(int samplingFreq) { instanceConstants(samplingFreq); instanceResetUserInterface(); instanceClear(); } ... The two itbl0 and ftbl0 tables are generated a class static pointers. The classInit method takes the additional dsp_memory_manager object used to allocate tables. A new classDestroy method is available to deallocate the tables. Finally the init method is now empty, since the architecure file is supposed to use the classInit/classDestroy method once to allocate and deallocate static tables, and the instanceInit method on each allocated DSP.","title":"Faust -mem option to control memory related code generation"},{"location":"community/news/#control-of-the-dsp-memory-allocation","text":"An architecture file can now define its custom memory manager by subclassing the dsp_memory_manager abstract base class, and implement the two required allocate and destroy methods. Here is an example of a simple heap allocating manager: struct malloc_memory_manager : public dsp_memory_manager { virtual void* allocate(size_t size) { void* res = malloc(size); cout << \"malloc_manager: \" << size << endl; return res; } virtual void destroy(void* ptr) { cout << \"free_manager\" << endl; free(ptr); } };","title":"Control of the DSP memory allocation"},{"location":"community/news/#controlling-the-table-memory-allocation","text":"To control table memory allocation, the architecture file will have to do: // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Allocate the dsp instance using regular C++ new mydsp* dsp = new mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Deallocate the dsp instance using regular C++ delete delete dsp; // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy();","title":"Controlling the table memory allocation"},{"location":"community/news/#controlling-the-complete-dsp-memory-allocation","text":"Full control the DSP memory allocation can be done using C++ placement new : #include <new> // Allocate a custom memory allocator malloc_memory_manager manager; // Setup manager for the class mydsp::fManager = &manager; // Placement new using the custom allocator mydsp* dsp = new(manager.allocate(sizeof(mydsp))) mydsp(); // Allocate static tables (using the custom memory allocator) mydsp::classInit(48000); // Initialise the given instance dsp->instanceInit(48000); ... ... // Calling the destructor dsp->~mydsp(); // Deallocate the pointer itself using the custom memory allocator manager.destroy(dsp); // Deallocate static tables (using the custom memory allocator) mydsp::classDestroy(); More complex custom memory allocators can be developed by refining this malloc_memory_manager example, possibly defining real-time memory allocators...etc... The OWL architecture file already uses this new custom memory allocator model. This is a work in progress: in the Faust2 branch, this model is still not supported yet beside the C++ backend custom memory allocator is not yet supported is additional DSP classes (like the mydsp_poly defined in the achitecture/faust/dsp/poly-dsp.h header).","title":"Controlling the complete DSP memory allocation"},{"location":"community/news/#2017-04-26-optimizing","text":"","title":"2017-04-26: Optimizing..."},{"location":"community/news/#optimizing-the-dsp-cpu-usage","text":"The Faust compiler has as lot of different compilation parameters to play with. Discovering them for a given DSP program is something that can be automated. Two measure_dsp and dsp_optimizer classes are available for developers to measure DSP CPU use directly in their code. Two more friendly faustbench and faustbench-llvm tools have been developed using them. They allow to discover the best Faust compiler parameters, to be used later on with faust2xx scripts, faustgen~ Max/MSP external or FaustLive .","title":"Optimizing the DSP CPU usage"},{"location":"community/news/#the-measure_dsp-and-dsp_optimizer-dsp-decorator-classes","text":"The measure_dsp class defined in the faust/dsp/dsp-bench.h file allows to decorate a given DSP object and measure its compute method CPU consumption. Results are given in Megabytes/seconds (higher is better). Here is a C++ code example of its use: static void bench(dsp* dsp, const string& name) { // Init the DSP dsp->init(48000); // Wraps it with a 'measure_dsp' decorator measure_dsp mes(dsp, 1024, 5); // Measure the CPU use mes.measure(); // Print the stats cout << name << \" CPU use : \" << mes.getStats() << endl; } Only part of the Faust2 branch and defined in the faust/dsp/dsp-optimizer.h file, the dsp_optimizer class uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. Here is a C++ code example of its use: static void dynamic_bench(const string& dsp_source) { // Init the DSP optimizer with the dsp_source to compile // (either the filename or source code string) dsp_optimizer optimizer(dsp_source, \"/usr/local/share/faust\", \"\", 1024); double value; // Discover the best set of parameters vector<string> options = optimizer.findOptimizedParameters(value); // Print the result cout << \"Best value is for '\" << argv[1] << \"' is : \" << value << \" with \"; for (int i = 0; i < options.size(); i++) { cout << options[i] << \" \"; } cout << endl; }","title":"The measure_dsp and dsp_optimizer DSP decorator classes"},{"location":"community/news/#using-the-faustbench-tool","text":"The faustbench tool uses the C++ backend to generate a set of C++ files produced with different Faust compiler options. All files are then compiled in a unique binary that will measure DSP CPU of all versions of the compiled DSP. The tool is supposed to be launched in a terminal, but it can be used to generate an iOS project, ready to be launched and tested in Xcode. Here are the available options: faustbench [-ios] [Additional Faust options (-vec -vs 8...)] <file.dsp> Use '-ios' to generate an iOS project Use 'export CXX=/path/to/compiler' before running faustbench to change the C++ compiler Use 'export CXXFLAGS=options' before running faustbench to change the C++ compiler options Here is a trace of its use: faustbench karplus32.dsp Selected compiler is g++ with CXXFLAGS = -Ofast -scal : 77.5123 -vec -lv 0 -vs 4 : 64.2194 -vec -lv 0 -vs 8 : 80.8951 -vec -lv 0 -vs 16 : 106.244 ..... -vec -lv 1 -vs 128 -g : 130.635 -vec -lv 1 -vs 256 -g : 134.335 -vec -lv 1 -vs 512 -g : 135.352 Best value is : 136.235 with -vec -lv 0 -vs 512","title":"Using the faustbench tool"},{"location":"community/news/#using-the-faustbench-llvm-tool","text":"Available in the faust2 branch only, the faustbench-llvm tool uses the libfaust library and its LLVM backend to dynamically compile DSP objects produced with different Faust compiler options, and then measure their DSP CPU. In the main Faust folder, use make bench && sudo make install to build and install the tool. Here is a trace of its use: faustbench-llvm karplus32.dsp Estimate timing parameters -scal : 21.1269 duration = 0.102801 count = 24318 Discover best parameters option -scal : 21.1034 -vec -lv 0 -vs 4 : 42.0734 -vec -lv 0 -vs 8 : 55.3725 -vec -lv 0 -vs 16 : 85.3855 ..... -vec -lv 1 -vs 128 -dfs : 133.974 -vec -lv 1 -vs 256 -dfs : 139.12 -vec -lv 1 -vs 512 -dfs : 91.8424 Refined with -mcd -vec -lv 0 -vs 256 -g -mcd 2 : 83.5555 -vec -lv 0 -vs 256 -g -mcd 4 : 138.519 -vec -lv 0 -vs 256 -g -mcd 8 : 140.122 -vec -lv 0 -vs 256 -g -mcd 16 : 141.558 -vec -lv 0 -vs 256 -g -mcd 32 : 139.454 -vec -lv 0 -vs 256 -g -mcd 64 : 143.405 -vec -lv 0 -vs 256 -g -mcd 128 : 142.975 -vec -lv 0 -vs 256 -g -mcd 256 : 139.345 Best value is for 'karplus32.dsp' is : 142.473 with -vec -lv 0 -vs 256 -dfs -mcd 64 w","title":"Using the faustbench-llvm tool"},{"location":"community/news/#2017-02-21-faust-meets-juce","text":"JUCE is an open-source cross-platform C++ application framework, used for the development of desktop and mobile applications. JUCE is used in particular for its GUI and plugins libraries. A set of architecture files have been developed to deploy standalone or plugins built from Faust code. They allow to automatically generate the GUI from the Faust program, possibly supporting polyphonic instruments, and be controlled by MIDI or OSC messages. The architecture files are then combined to produce ready to compile JUCE applications or plugins, using tools that are part of the Faust distribution. They can also be accessed using the Faust online compiler.","title":"2017-02-21: Faust meets JUCE"},{"location":"community/news/#faust2juce-script","text":"faust2juce transforms a Faust DSP program into a fully working JUCE standalone application or plugin, which can possibly be controlled with MIDI or OSC messages. Read its complete description here . You'll have to get a recent github version of Faust tree to use it.","title":"faust2juce script"},{"location":"community/news/#using-the-online-compiler","text":"The Faust online compiler has been updated to provide new 'juce' targets. Note that only some of the possible compilation options are availble for now: the application target produces a standalone MIDI controlable application (using Faust polyphonic code if the Faust source code is polyphonic aware) the plug-in target produces a MIDI controlable mono or polyphonic plugin (using Faust polyphonic code if the Faust source code is polyphonic aware) the jsynth target produces a MIDI controlable mono or polyphonic plugin (using JUCE polyphonic Synthesizer if the Faust source code is polyphonic aware) Directly using faust2juce provides the full control of the generated target with access to all possible compilation parameters.","title":"Using the online compiler"},{"location":"community/news/#graph-of-faust-generated-plugins","text":"Here is an example of three Faust generated plugins running in JUCE plugin host:","title":"Graph of Faust generated plugins"},{"location":"community/news/#using-libfaust-and-llvm","text":"An alternative to faust2juce static-compilation model, is to use Oliver Larkin's juce_faustllvm module, also used in his pMix2 tool .","title":"Using libfaust and LLVM"},{"location":"community/news/#2017-01-13-webassembly","text":"","title":"2017-01-13: WebAssembly..."},{"location":"community/news/#faust-webassembly-backend","text":"WebAssembly was born with the premise of creating a safe, portable and fast to load and execute format suitable for the web. WebAssembly its not a programing language but a compilation target with a text and binary specs. That means that other low level languages like C/C++, Rust, Swift, etc. can compile to WebAssembly. Specified and developed by principal browser compagnies (Google, Mozilla, Microsoft and Apple), this new format aims to finally replace the more hackish \"asm.js\" format initialy developed by Mozilla. Development versions of Chrome and Firefox can already execute it. To get an early preview of this experimental technology, at your own risk: on Chrome Canary , open chrome://flags/#enable-webassembly and enable the switch on Firefox Nightly , open about:config and set javascript.options.wasm to true See a preview of Microsoft Edge support and follow Safari support on WebKit\u2019s feature status .","title":"Faust WebAssembly backend"},{"location":"community/news/#webassembly-backends","text":"New WebAssembly backends have been added in the faust2 development branch. They allow to generate textual or binary WebAssembly code.","title":"WebAssembly backends"},{"location":"community/news/#wast-textual-backend","text":"The 'wast' backend allows to generate textual WebAssembly code (in s-expression like format). Note that as of january 2017, the official textual format is not yet fully specified, thus we follow the format used in the binaryen tool . Use the following command to generate the textual output in the terminal for a given foo.dsp file. faust -lang wast foo.dsp The following command: faust -lang wast foo.dsp -o foo.wast will generate the foo.wast textual WebAssembly output file as well as an additional foo.js JavaScript file containing glue code.","title":"'wast' textual backend"},{"location":"community/news/#wasm-binary-backend","text":"The 'wasm' backend allows to generate binary WebAssembly code. Use the following command to generate the binary output in the terminal for a given foo.dsp file. faust -lang wasm foo.dsp The following command: faust -lang wasm foo.dsp -o foo.wasm will generate the foo.wast binary WebAssembly output file as well as an additional foo.js JavaScript file containing glue code.","title":"'wasm' binary backend"},{"location":"community/news/#generating-static-html-pages","text":"WebAssembly code can be feeded into WebAudio JavaScript nodes, which can then be used like any other native WebAudio node. Two scripts are available to generate static WebAudio html pages from a given foo.dsp source file with the generated html/css/svg user interface: faust2webaudiowast foo.dsp will generate the textual WebAssembly output, use binaryen wasm-as tool to convert the wast to wasm format (you'll have to compile and install the binaryen tools on your machine), and produce a self-contained html page. faust2webaudiowasm foo.dsp will generate the binary WebAssembly output that can directly be loaded by the produced self-contained html page. Page containing polyphonic instruments can be generated with the following commands: faust2webaudiowast -poly foo.dsp to use the 'wast' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument. faust2webaudiowasm -poly foo.dsp to use the 'wasm' backend and a polyphonic ready foo.dsp, and create a self-contained html page ready to be used with a MIDI instrument.","title":"Generating static HTML pages"},{"location":"community/news/#2016-10-17-faust-award-2016","text":"The Faust Open Source Software Competition aims at promoting innovative high-quality free audio software developed with Faust, a functional programming language for realtime signal processing and sound synthesis. The competition is sponsored by GRAME , Centre National de Cr\u00e9ation Musicale","title":"2016-10-17: Faust Award 2016"},{"location":"community/news/#faust-award-2016-to-ambitools","text":"The Faust Award 2016 was attributed by an international committee composed of : Jean-Louis Giavitto (IRCAM, Paris, France), Albert Graef (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (Stanford U., Palo Alto, USA) Yann Orlarey (GRAME, Lyon, France), Dave Phillips (musician, journalist, and educator, USA) Laurent Pottier (U. Jean Monnet, Saint-Etienne, France), Julius Smith (Stanford U., Palo Alto, USA) to Ambitools , a set of tools for real-time 3D sound field synthesis using higher order ambisonics (HOA). Ambitools is developed by Pierre Lecomte, a PhD candidate at Conservatoire National des Arts et M\u00e9tiers and Sherbrooke University. The core of the sound processing is written in Faust. The tools contain HOA encoders, decoders, binaural-filters, HOA signals transformations, spherical VU-Meter, etc. and can be compiled in various plug-ins format under Windows, Mac OSX, and Linux. The jury praised the quality and the usefulness of Ambitools: a really useful and technically advanced Faust app and an impressive technical achievement ! Check the demo . The committee was also very impressed by the quality of two other projects : Voice of Faust , a voice synthesizer/effects machine by Bart Brouns ( demo ). PMix , a graphical patcher, preset interpolator and JIT compiler for FAUST by Oliver Larkin ( demo ).","title":"Faust Award 2016 to Ambitools"},{"location":"community/news/#faust-student-software-competition-to-touchvoices","text":"In parallel to the main competition, we introduced this year a junior competition: the Faust Student Software Competition , intended to promote small but interesting Faust applications, typically written as student projects. The student prize was awarded to TouchVoices (by Pierre-Adrien Th\u00e9o, RIM Master student at University Jean Monnet) a real-time web application allowing to capture, playback and transform sound loops. Here is a video of Pierre-Adrien Th\u00e9o during a performance with TouchVoices . A very close competitor was SuperBeatRepeater (by Vincent Rateau, of SuperDirt fame), a sample accurate beat repeater. Don't miss the demo !","title":"Faust Student Software Competition to TouchVoices"},{"location":"community/news/#2016-08-30-faust-book","text":"","title":"2016-08-30: FAUST book..."},{"location":"community/news/#the-first-faust-book-is-korean","text":"\u201c Sound Programming using FAUST \u201d, written by Jin-Wook Chae , an experienced audio developer and sound engineer (right) and Hyun-Hoo Jung (left), is the very first book ever published on FAUST. While the book is written in Korean, I was able to really appreciate the choice of the examples and the elegance as well as the high quality of the code. I am sure it will be an invaluable tool to promote FAUST in Korea among sound engineering, computer music students and more generally any person interested in sound programming. This book is for people desiring to produce musical instruments or sound processors. I have always been instructing my students that the ultimate importance is to discover interesting ideas about the sound. In spite of that, I have often relied on an unflattering response such as \"you may need to learn a programming language like C/C++...\" when a student asked for help with how to execute his/her ideas related to sound. Now I am pleased to recommend the use of FAUST to bring such ideas into execution. This is an easy self-study guide that can help to do just that. Now I can confidently tell anybody pursuing sound or electronic music that their exciting and brilliant idea about sound is what truly counts! So, really, how do we execute our ideas? Today I am introducing you to FAUST and to this book which you will find immensely helpful in terms of how to use FAUST to bring your fabulous ideas into reality. Jinwook Chae","title":"The first FAUST book is Korean !"},{"location":"community/news/#2016-06-30-faust-interpreter","text":"A new 'interpreter' backend has been added in the faust2 development branch. It allows to execute Faust programs without using the LLVM dynamic compiler chain.","title":"2016-06-30: Faust interpreter"},{"location":"community/news/#interpreter-compilation-chain","text":"The dynamic compilation chain allows developers to embed the Faust compiler technology directly in their application or plugins. Faust2 development branch uses an intermediate FIR representation (Faust Imperative Representation), which can be translated to several output languages. An LLVM backend has been previously developed to allows applications to compile a DSP source into executable code in memory, bypassing the external compiler requirement. In some specific situations, embedding the LLVM chain is not possible : for instance Apple does not allow to deploy dynamic compilers on iOS. Thus having an interpreter backend allows to get around this problem and still make Faust code run on those platforms.","title":"Interpreter compilation chain"},{"location":"community/news/#interpreter-backend","text":"The interpreter backend translates the FIR intermediate language into instructions for a virtual machine. A pure C++ interpreter for this instruction set has been implemented.","title":"Interpreter backend"},{"location":"community/news/#running-and-performances","text":"The interpreter backend translates the FIR intermediate language into bytecode for a virtual machine. It allows to run programs about 4 to 5 slower than native speed . Moreover this interpreter can be compiled in a special 'trace' mode to automatically detect various execution errors : invalid heap access, mathematical errors or warnings (division by zero, integer overloading....) which helps us to check the compiler semantic and code generation quality.","title":"Running and performances"},{"location":"community/news/#deployment-for-developers","text":"Given a Faust source code (as a file or a string), calling the createInterpreterDSPFactoryXXX function runs the compilation chain (Faust + interpreter) and generates the \u201cprototype\u201d of the class, as a interpreter-dsp-factory pointer. class interpreter_dsp_factory : public dsp_factory { public: /* Return Factory name */ std::string getName(); /* Return Factory SHA key */ std::string getSHAKey(); /* Return Factory expanded DSP code */ std::string getDSPCode(); /* Creates a new dsp instance */ dsp* createDSPInstance(); }; Note that the library keeps an internal cache of all allocated factories so that the compilation of the same DSP code, that is same source code and same set of 'normalized' (= sorted in a canonical order) compilations options, will return the same (reference counted) factory pointer. You will have to explicitly use deleteInterpreterDSPFactory to properly decrement the reference counter when the factory is no more needed. You can get a unique SHA1 key of the created factory using its getSHAKey method. Next, the createDSPInstance function, corresponding to the new className of C++, instantiates a interpreter-dsp pointer to be used through its interface, connected to the audio chain and controller interfaces. When finished, simply use delete to destroy the dsp instance. class interpreter_dsp : public dsp { public: void metadata(Meta* m); int getNumInputs(); int getNumOutputs(); void init(int samplingRate); void instanceInit(int samplingRate); dsp* clone(); void buildUserInterface(UI* inter); int getSampleRate(); void compute(int count, FAUSTFLOAT** input, FAUSTFLOAT** output); }; Since interpreter_dsp is a subclass of the dsp base class, an object of this type can be used with all already available audio and UI classes, in essence reusing all architecture files already developed for the static C++ class compilation scheme (like OSCUI, httpdUI interfaces etc.), see Developing a new architecture file .","title":"Deployment for developers"},{"location":"community/news/#savingrestoring-the-factory","text":"After the DSP factory has been compiled, your application or plugin may want to save/restore it in order to save Faust to interpreter bytecode compilation at next use. To get the internal factory compiled code, several functions are available: writeInterpreterDSPFactoryToMachine allows to get the interpreter bytecode as a string, writeInterpreterDSPFactoryToMachineFile allows to save the interpreter bytecode in a file, To re-create a DSP factory from a previously saved code, several functions are available: readInterpreterDSPFactoryFromMachine allows to create a DSP factory from a string containing the interpreter bytecode, readInterpreterDSPFactoryFromMachineFile allows to create a DSP factory from a file containing the interpreter bytecode. The complete API is available and documented in the installed faust/dsp/interpreter-dsp.h header.","title":"Saving/restoring the factory"},{"location":"community/news/#2016-04-07-web-audio-api","text":"","title":"2016-04-07: Web Audio API"},{"location":"community/news/#faust-and-the-web-audio-api-3","text":"The Faust compiler can now directly be used in a Web page. Thanks to the Emscripten compiler, the Faust compiler itself can be compiled to asm.js JavaScript. This has been done by compiling the libfaust C++ library to the libfaust.js JavaScript library, that exports a unique entry point.","title":"Faust and the Web Audio API (3)"},{"location":"community/news/#compiling-dsp-to-javascript-asmjs","text":"The libfaust.js exported function createAsmCDSPFactoryFromString(...) allows to create a DSP factory from a given DSP program as a source string and a set of compilations parameters, uses the Faust compiler asm.js backend, and produces the complete asm.js module and additional pure JavaScript methods as a string. Then calling JavaScript 'eval' function on this string compiles it in the browser. The dynamically created asm.js module and additional pure JavaScript methods can then be used. This internal code in then wrapped with additional JavaScript code. A DSP \u201cfactory\u201d will be created from the DSP source code with the following 'synchronous' code (if using the 'libfaust.js' library): var factory = faust.createDSPFactory(code, arguments); or possibly (if using the 'libfaustworker.js' library in the 'asynchronous' model): faust.createDSPFactory(code, arguments, callback); where 'code' is the DSP source as a string, and 'arguments' is an array of parameters to be given to the Faust compiler (like '-vec', '-vs 512'...), and 'callback' is a function taking the created 'factory' as argument. When no more used, you'll have to explicitly use the following code the deallocate the factory: faust.deleteDSPFactory(factory); Your application may want to save the already compiled factory as asm.js/JavaScript code to speed-up possible restore at later time: var machine_code = faust.writeDSPFactoryToMachine(factory); And restore the factory with the following code: var factory = faust.readDSPFactoryFromMachine(machine_code);","title":"Compiling DSP to JavaScript (asm.js)"},{"location":"community/news/#using-dsp-instances","text":"A fully working DSP \u201cinstance\u201d as a Web Audio node is then created with the code: var dsp = faust.createDSPInstance(factory, audio_context, buffer_size); When no more used, you'll have to explicitly use the following code to deallocate the instance: faust.deleteDSPInstance(dsp); This instance can be used like the statically compiled one, as previously described in this page .","title":"Using DSP instances"},{"location":"community/news/#polyphonic-instruments","text":"Polyphonic instruments can be produced. For a given 'factory' the following code will create a 16 voices polyphonic instance: var dsp = faust.createPolyDSPInstance(factory, audio_context, buffer_size, 16); This instance can be used like the statically compiled one, as previously described in this page .","title":"Polyphonic instruments"},{"location":"community/news/#using-faust-javascript-library","text":"The Emscripten compiled Faust library can be used in two ways. Either using the 'libfaust.js' library: <script src=\"libfaust.js\"></script> <script src=\"webaudio-asm-wrapper.js\"></script> or if using worker mode with the following code which loads the 'libfaustworker.js' library: <script src=\"webaudio/webaudio-asm-worker-wrapper.js\"></script>","title":"Using Faust JavaScript library"},{"location":"community/news/#2016-02-05-faust-award-2016","text":"","title":"2016-02-05: Faust Award 2016"},{"location":"community/news/#faust-award-2016-deadline-june-1-2016","text":"The Faust Open-Source Software Competition is intended to promote innovative high-quality free audio software developed with the Faust programming language, as well as development tools build around the Faust compiler itself. The Faust Open-Source Software award will be attributed to the best submission by an international committee of leading experts in the field. The competition is sponsored by Grame, centre national de cr\u00e9ation musicale. The winning software will receive a 2000\u20ac price to encourage its authors. The results will be announced July 15, 2016. To participate, the software must be provided with source code and licensed with a Free/Open Source license. A substantial part of the software must be written in Faust and the Faust source code must be provided. As part of the review process, the software will be built from the sources. All source code, license, video demonstration, installation instructions, and any other documentation must be available on a public web page. License compatibility with other open source software is encouraged. Dependencies on non-open source third-party software are discouraged, with the exception of operating systems and freely available commercial packages. Authors are required to prepare a video demonstrating the software. This video must be done carefully, and should convincingly present the qualities of the software. The submission must also contain any useful documentation, including examples of how the provided software might be used, existing prototypes that use the software, download statistics or other public usage information. The criteria for judging submissions includes broad applicability and potential impact, novelty, technical depth, reusability, etc.","title":"Faust Award 2016: deadline June 1, 2016"},{"location":"community/news/#junior-competition_1","text":"In parallel to the Faust Open-Source Software Competition we introduce this year a junior competition, the Faust Student Software Competition, with a 200\u20ac prize for the winner. The Faust Student Software Competition is intended to promote interesting audio processing and synthesis applications written in Faust in a single file in less than 1000 words. The word count is done after removing the comments from the code: cat foo.dsp | stripcmt | wc -w. The use of the standard Faust libraries is strongly encouraged. They don't take part in the word count.","title":"Junior Competition"},{"location":"community/news/#important-dates_2","text":"Start of the competition: February 8, 2016 Software Submission Deadline: June 1, 2016 Results of the competition: July 1, 2016","title":"Important dates"},{"location":"community/news/#submission-guidelines_1","text":"Authors interested in participating in the Faust Open Source Software Competition or the Faust Student Software Competition should send a submission email to faustaward@grame.fr with a PDF file attached containing the following information: Title of submission, Category of submission ( Faust Open Source Software Competition or Faust Student Software Competition ), Name, email and affiliation of the main author, Names, emails and affiliations of other authors, A permanent link for the open source software (e.g., Sourceforge, GitHub, Google Code, etc.), A permanent link for the video demonstration (e.g., YouTube, Vimeo, etc.), A link to a compressed archive file that contains the software (source code, documentation, build/install instructions, and licenses). Comprehensive and clear build/install instructions will be a crucial component of any submission. The committee will make a reasonable effort to build the software for the top contributions, but if they are unable to make the software run, it will be excluded from the competition.","title":"Submission Guidelines"},{"location":"community/news/#international-committee_1","text":"Jean-Louis Giavitto (IRCAM, Paris, France), Albert Gr\u00e4f (Johannes Gutenberg U., Mainz, Germany), Pierre Jouvelot (Ecole des Mines, Paris, France), Victor Lazzarini (Maynooth U., Maynooth, Ireland), Romain Michon (CCRMA, Stanford , USA) Yann Orlarey (Grame, Lyon, France), Dave Phillips (Musician/Journalist, Findlay, USA) Laurent Pottier (U. Jean Monnet, Saint Etienne, France), Julius Smith (CCRMA, Stanford , USA)","title":"International Committee"},{"location":"community/news/#previous-winners_1","text":"2015: Guitarix , by Hermann Meyer and Andreas Degert","title":"Previous Winners"},{"location":"community/powered-by-faust/","text":"Powered By Faust This page lists the projects using Faust in different ways: musical pieces or artistic projects, plugins or standalone applications, integration in audio programming environments, development tools, commercial applications, research projects (possibly non musical), embedded devices, Web applications, etc. Faust in Cables.jl Explore the dynamic integration of the Faust audio library within Cables in this video. This segment delves into the intricacies of generating rich audio experiences on the web, leveraging Faust's advanced capabilities for real-time audio synthesis with synthesizers and oscillators. Discover how to seamlessly compile, modify, and visualize audio within Cables, enhancing your projects with intricate audio-visual synchronization and interactive controls, inviting viewers to contribute and experiment with this powerful tool. polyBLEP HOLE A Faust collection of externals for Pure Data stuck together on the Organelle . The polyBLEPs are the work of Jacek Wieczorek. v1.1 triples the oscillators as sounded a bit thin. The greyhold reverb is immense. OneTrick KEYS A physically modeled piano synth with a chill lo-fi sound. It uses a vintage algorithm developed at Stanford in 1995 called \"Commuted Piano Synthesis\", and runs that through studio reverb, vinyl or tape noise, flutter, bitcrushing, and saturation. The project is using Rust and the Faust to Rust backend, and the source code is available . MOD Audio The compact and powerful standalone guitar effects ecosystem to express your creativity at home, in the studio and on stage, which can be programmed with Faust . nih-faust-jit A plugin to load Faust dsp files and JIT-compile them with LLVM. A simple GUI is provided to select which script to load and where to look for the Faust libraries that this script may import. The selected DSP script is saved as part of the plugin state and therefore is saved with your DAW project. ambient.garden ambient.garden is a musical landscape in a website, developed using Teasynth with these Faust codes . All the music in ambient.garden is generated from code. The music is then laid out in a landscape which can be explored, either interactively, or automatically when the autopilot is left on. Teasynth Teasynth is a tool to make music with code in Javascript, Faust and Sporth . There are two main ways of using it: The web editor runs in the browser and provides an instant composition environment. The command line interface can render music to audio files, serve the editor locally, and bundle music code. LICH Technology OWL platform that allows you to use Pure Data, Max Gen or Faust code into your module!. Lich is a Befaco Rebel collaboration that brings back Owl\u2019s platform with this new hardware iteration. It has stereo in and out, four pot controls summed to cv inputs (like the classic Owl module) And as addition, CV and Gate outputs, patch selection with display and USB MIDI host and device connections. lamb A lookahead compressor/limiter that's soft as a lamb, written in Faust and Rust. Lamb was made with these goals in mind: Be as clean as possible Give the user full control over the character with the minimum amount of knobs. FaustSynth Welcome to FaustSynth, a AU/VST monophonic synthesizer built with the Faust programming language. This is the project deliverable for PAT 481: Independent Study in Fall 2023. EnvelopForLive The nonprofit mission of Envelop is to connect and inspire community through immersive listening. Our listening spaces envelop the audience in pristine 3D sound, amplifying the power of music and nurturing our ability to listen together. Some Max/MSP externals are written in Faust . RCVerb (\"ReaClassical Verb\") A reverb suitable for classical music based on zita-rev1. Available as LV2 and CLAP by default (with optional VST3, VST2 and LADSPA). This plugin is part of the ReaClassical project along with RCComp (\"ReaClassical Compressor\") and Enover (RCVerb's big sister) additionals plugins, also written in Faust. Wam-Studio Wam-Studio\u2019s is an online tool for creating audio projects that you can imagine as multi-track music. Each track corresponds to a different \"layer\" of audio content that can be recorded, edited, or just integrated (using audio files for example). Some track can be used to control virtual instruments: in that case we record the sound that is generated internally by these virtual instruments (and played using a MIDI piano keyboard, for example). Tracks can be added or removed, played isolated or with other tracks. They can also be \"armed\" for recording, and when the recording starts, all other tracks will play along, while the armed track will record new content. Wam-Studio can host WAM plugins and in particular Faust ones , which can be built following this tutorial . SNES Echo Simulator SNES Echo is an cross-platform audio processing plugin, written in Faust. It simulates the SNES SPC700 DSP reverb/echo effect. This plugin does not strive for bit-accuracy and overflow handling, but instead being audibly indistinguishable for \"normal\" SPCs. Syfala project Automatic compilation of Faust audio DSP programs for AMD-Xilinx FPGAs, developed by the Emeraude team , and funded by the FAST ANR project. Supported board models are: Digilent Zybo Z7-10 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Zybo Z7-20 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Genesys ZU-3EG - Zynq UltraScale+ MPSoC Development Board Interactive Granular Texture Synthesiser An interactive granular texture synthesiser built in TouchDesigner, utilising real time signal processing of the domain-specific language Faust (functional audiostream), and the corresponding TD_Faust operator. Reflex-in Reflex-in is a sound installation that uses brain-wave streams to create music composition within the Web environment in real time. The work incorporates various state-of-the-art Web technologies, including Web Audio, WebSocket, WebAssembly, and WebGL. The music generated from the algorithm - mapping brain wave signal to musical events - aims to produce a form of furniture music that is relaxing and meditative, possibly therapeutic. The synthesizer part is created from Faust DSP and the installation can be tested here . FaustCGP Generate new audio synthesizers and filters in FAUST with Recurrent Cartesian Genetic Programming. Given a target sound or impulse response as input, the RCGP will return a FAUST synthesizer or filter, respectively, that best approximates the given signal or impulse response. Samples for an early version of the software can be found here . OneTrick URCHIN A hybrid drum synth that models the gritty lo-fi sound of beats from vintage records without sampling. It takes spectral and physically modeled drums, running them through simulated studio reverb, a vinyl or tape player, and finally a digital sampler. The result is a fat and saturated drum machine that creates a vibe of sampling with the control of a synthesizer. The project is using Rust and the Faust to Rust backend, and the source code is available . KBVerb A Faust reverb, based on the Midiverb architecture by Keith Barr . pasfa - Paste Faust code! A paste service for Faust code, to be tested here . FAUSTmapper FAUSTmapper is a tool for binding popular Digital Musical Intrument (DMI) mapping tools to the FAUST ecosystem. The default action for the FAUSTmapper project is establishing a binding to the libmapper project. When the script is run, the entire parameter space of an active FAUST project (with HTTP control enabled) will be discovered. Once discovered, a libmapper signal will be created for each of the parameters identified, including appropriate meta data such as min, max & default values. The following poster was presented at the 4th Annual International Symposium on the Internet of Sounds and was awarded the Best Poster Award. phausto Pharo is a pure object-oriented programming language and a powerful environment, focused on simplicity and immediate feedback (think IDE and OS rolled into one). Phausto allows to use Faust inside Pharo. Cantor Digitalis The Cantor Digitalis is a singing voice synthesiser controlled in real time by chironomy, i.e. by manual gesture, using interfaces such as a stylus or the fingers on a graphics tablet. More generally, it can be controlled using any MIDI interface. The synthesiser has been reimplemented in Faust by Gr\u00e9goire Locqueville during his PhD thesis . Karya Karya is a score language editor with support for scales, instrumental techniques, and ornaments, with special support for Balinese, Javanese, and Carnatic music. It has backends for MIDI, supercollider OSC, lilypond, and an incremental audio renderer that uses Faust or samples. You can write instruments in Faust and integrate them into a score along with samples and MIDI instruments. Due to incremental rendering, even computationally expensive instruments are not a problem. Body Brain Digital Musical Instrument (BBDMI) BBDMI project aims at making music from electrical signals of the muscle and the brain using EMG and EEG technologies. Producing instrumental prototypes in an open way (open software and open hardware) and to document them in the framework of open science (FAIR). The modular system is built with Max/MSP and interfaced with Faust for the purpose of analyzing, processing and mapping electrophysiological signals to sound. The paper An Interactive Modular System for Electrophysiological DMIs received a best paper award at Audio mostly 2023 . The Spatbox The Spatbox is an interface to intuitively generate 3D trajectories and to spatialize them in real-time on a loudspeaker array with Ambisonics, developed by Pierre Lecomte . Each trajectory is described by a parametric curve, where each of the coordinates varies according to a configurable LFO. Depending on the LFO parameters, many trajectories can be generated. The implementation is done in Faust and the project has been presented at PAW 2022 . MUSS3640 Vocal Synthesiser The MUSS3640 Vocal Synthesiser is a standalone application/VST3 plugin developed to allow exploratory synthesis of the singing voice. It implements a combination of formant-wave-function and bandpass synthesis techniques. The DSP is written in Faust. RITI: Room Is The Instrument RITI: Room Is The Instrument by Luca Spanedda , is a piece based on a complex system capable of manifesting emergent and chaotic behaviors, where the acoustic personality of an environment (digital or physical) becomes a case of study for the performance and is reflected in terms of variation in the behavior of the system itself. The DSP code is written in Faust. See a video of a \"studio\" performance of the system . EQUIS EQUIS is a 4 Channel DJ Mixer built on top of JACK. It's EQ is inspired by the Playdifferently Model1 and offers per channel a highpass, lowpass and sculpt eq. The code is developed in Rust and the DSP is written in Faust . See the video presentation at Sonoj convention . ESP32 Wrover E/IE audio dev board A board to play with FAUST sound synthesis language. Kuroscillators Max/MSP objects for audio and rhythmic synthesis using coupled oscillator networks. Coupled Oscillators networks are dynamical systems that describe how ensembles of interacting elements are able to self-organize and synchronize over time. In terms of sensory perception, they have been examined in a wide range of fields including those related to rhythmic entrainment, biomusicology, psychoacoustics, signal processing, and generative music. The DSP is written in Faust . Jou\u00e9 Music Instruments A new way to make music: the Jou\u00e9 Play is a system that combines an expressive multi-instrument, an intuitive app & interactive content, with a range of musical instruments that use touch-sensitive technology to create a unique playing experience. These instruments are designed to be highly expressive, allowing musicians to play with greater nuance and emotion. Part of the audio effects are coded in Faust. ExternalChugins Chugins , short for \"ChucK plugins,\" are plugins for the ChucK programming language . ChucK is an audio programming language that allows for real-time synthesis, composition, and performance of music. Chugins extend the functionality of ChucK by providing additional classes, objects, and modules that can be used to create more complex and intricate music and sound designs. ExternalChugins are a set of chugins exported from Faust. mesh2audio Generate axisymmetric 3D models, or import existing 3D models, and transform them into real-time playable physical audio models! Supports fast DSP generation of physical audio models that sound decently realistic, as well as blazing fast 2D axisymmetric model generation, at the expense of some fidelity. It is an improvement of the mesh2faust tool. The generated audio model can be played in real-time by \"striking\" (clicking) on mesh vertices in the 3D mesh viewer. OneTrick CRYPTID Whispers of a dreaded drum machine with the cold clanging heart of a DX7 in the fearsome frame of a TR-808 echo in dusty backrooms of backstreet recording studios. A contraption conjured under cover of darkness in the heinous pursuit of chart topping tracks, known only as the DX-808. It's time to bring the beast out of the shadows! Allow us to present the world's most accurate recreation of an FM drum synth skeptics say never actually existed. Using a DX7 emulator of our own design, we forged each facet of the CRYPTID, reconstructing its wretched inner-workings. From the \"Log Drum\" Toms to the \"Wood Block\" Cowbell. Blow that Samba Whistle and hit the Gong! Do you want to believe? The project is using Rust and the Faust to Rust backend, and the source code is available . Bespoke Anywhere This paper reports on the Audio Anywhere project, a framework for working with audio plugins that are compiled once and run anywhere. At the heart of Audio Anywhere is an audio engine whose Digital Signal Processing components are written in Faust and deployed with WebAssembly, by Benedict Gaster and Ryan Challinor, presented at Nime 2021 . A Technical Framework for Musical Biofeedback in Stroke Rehabilitation We here present work a generalized low-level technical framework aimed to provide musical biofeedback in post-stroke balance and gait rehabilitation, built by an iterative user-centered process. The framework comprises wireless wearable inertial sensors and a software interface developed using inexpensive and open-source tools. The interface enables layered and adjustable music synthesis, real-time control over biofeedback parameters in several training modes, and extensive supplementary functionality. JUCE and FAUST are used to create a versatile architecture for layered, yet computationally efficient real-time music synthesis. ForceHost ForceHost: an open-source toolchain for generating firmware embedding the authoring and rendering of audio and force-feedback haptics, by Christian Frisson, Mathias Kirkegaard, Thomas Pietrzak, and Marcelo M. Wanderley presented at Nime 2022 . The Faust compiler has been modified to support haptics. Sentinelle Sentinelle is a sound and robotic art installation made by J\u00e9r\u00f4me Abel . A robot-probe is placed in a dark place, a cellar. It scans its surroundings with two lasers. The reliefs of the old walls, their imperfections, mold, appear thanks to the perfectly straight lines of the lasers. Its movements are synchronized with a sound program. From these very simple visual and sound choreographies are born an imaginary on its functioning and the origin of its presence. The spectator observes in a mirror a robot which observes and testifies. Does it communicate with other systems? Does it send information? Its energy is precious, like a heartbeat or a breath, it works in a segmented way with periods of silence. Likewise, his movements are slow and relentless. Faust objects from https://github.com/grame-cncm/faust/tree/master-dev/examples included with pd-faustgen : examples/gameaudio/bubble examples/delayEcho/echo examples/gameaudio/rain examples/generator/sawtoothLab lang.faust~ and ui.faust~ CEAMMC PureData distribution 2023.02. General purpose Pd distribution and library used for work and education purposes in Centre of electroacoustic music of Moscow Conservatory ( CEAMMC ) and ZIL-electro studio. This repository is an assembly of Puredata that includes the CEAMMC library. It includes the lang.faust~ and ui.faust~ externals and a lot of Faust DSP . arco4 - sound synthesis engine and framework Arco is a sound synthesis engine that offers dynamic patching of of unit generators. It is designed to operate as a small embedded server, running either in its own process or within an application. In the spirit of \"smaller is better,\" Arco DSP is mainly delegated to FAUST , leveraging a wide range of existing algorithms. Arco control is delegated to external languages connecting through O2, which supports running Arco within the same application, in a separate process or even on a remote networked host. Arco should be a nice alternative to libpd as an embedded sound engine. The author is mainly using Arco in tandem with Serpent, a real-time Python-like scripting language, but other language bindings are possible. Synthesizer-synthesizer This is a dual-course project for CS378 NLP and CS393P. The goal is to use language model guided program synthesis to synthesize Faust DSP code to ... automatically program synthesizers. Not guaranteed to work. In the slightest. Ambisonics in KMH studios and Lilla salen The general idea behind using ambisonics for diffusing sounds in a space is to, in the first stage, encode an audio signal to a representation of a sound field - a B-format signal. This B-format signal is independent of whatever speaker array the signal will later be diffused on. In the second stage the B-format signal is decoded to the layout of a particular speaker array. In between these two stages a number of transformations may be applied, but the sound source specification may conveniently be specified in the encoder. The decoders are written in Faust. Sardine Sardine is a free/open-source software for Python 3.10+. It turns Python into a musical instrument. You can play it alone or with your friends. With Sardine you can: Play synthesizers and audio samples using SuperCollider. Control synthesizers through MIDI/OSC messages. Interconnect audio/video softwares and/or sound engines. Play collaboratively with your friends. Extend your musical environment using any Python package. Faust written DSP can be used in Sardine. KandiskyScore KandiskyScore is a graphical editor for the analysis and creation of electroacoustic/acousmatic music. It is an html/javascript application. It works perfectly with Firefox, Chrome and Opera and therefore on all Windows, OSX, Linux and other PCs. It uses the WebAudio API for sound generation and the Faust language of the GRAME for plugins. It also allows you to export a graphic score in SVG format that you can eventually modify with a vector graphics software like Inkscape or LibreOffice-draw. fildesoi1_2_3 Software (including Faust code , Max and PureData patches) to perform Fil de Soi 1 and Fil de Soi 2, mixed music pieces by Alain Bonardi for acoustic guitar and electronics. enecho Faust code for En Echo piece by Manoury for soprano and live electronics. Zen Flute The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board . souffle An electro track made with Faust . You can listen to a recording here . GHG (Gruppenhorchger\u00e4t) The project is a demonstration of a technique called delay-sum beamforming with the aim to replicate the sound heard by operators of passive sonar devices used in the second world war. Listen to the video here . The simulation code is written in Faust. Satuverb Satuverb is a flexible reverb that has many creative and natural sounding uses, produced by request for FBPM. It has a saturator and EQ controls inside the reverberator, which apply every time the signal is fed back. This causes the effects to grow more extreme as the reverb tail trails off. Satuverb's reverberator is based on Jon Dattorro's 1997 design and written in Faust . faustilogue Convert Faust DSP files to KORG logue custom oscillators, using the logue SDK . Blippoo for Wingie Blippoo for Wingie is an alternative firmware for Wingie2. The new firmware is inspired by Blippoo Box, a genius instrument created by Rob Hordijk (1958-2022), who contributed a lot to synthesizer design. May his spirit lives on in his instrument designs, thoughts, and influences. The new firmware could turn your Wingie2 into a self-contained instrument capable of producing a variety of sounds and patterns. As a great companion, it will help you in your music-making practice especially when you want to applicate controlled chaos in your music. The DSP is written in Faust . 6171_reverb A vintage reverb based on designs from 1961 and 1971, written in Faust . teensy-wfs Distributed Wave Field Synthesis (WFS) implementation for networked Teensies. There is a WFS Controller JUCE app in wfs-controller. This uses JACK's C API to set up ports and connect to any Teensy JackTrip clients. It notifies the clients of their positions in the WFS array, plus the positions of virtual sound sources, via OSC over UDP multicast. The WFS algorithm is written in Faust . pd-remote This is a simplified and unified version of the Pd remote control helpers that I've been distributing with various Pd externals such as pd-faust and pd-lua over the years. The present implementation will work with any of these and replaces the more specialized versions. It takes the form of a Pd abstraction pd-remote.pd and an accompanying pd-remote.el elisp file for Emacs. Crossroad2Effects Crossroad2Effects, the functional successor to @jatinchowdhury's CrossroadsEffects , is a genetic algorithm infrastructure for filter exploration. Provided with dry and wet sound file, Crossroad2Effect determines the filter that tampered the dry file and presents it as a Faust program. This allows users to have granular access to analog or VST filters through a programming interface. This project constructs its genetic algorithm search on top of pedalboard, Spotify's new plugin API. flatten What is an envelope flattener ? It's similar to an automatic gain control, compressor, or maximizer in that it acts by modifying the gain of the signal according to a control signal. Like these, the control signal is derived from the envelope of the input signal. The DSP is written in Faust . drumvoice Drumvoice is a percussion instrument LV2 plugin. Drumvoice can also make lots of other percussion sounds, like kick drums, toms, single hand claps, and all kinds of smaps and blinks. The DSP is written in Faust . Verber Verber is a simple audio plugin tool with a Sweet, Lushy reverb processor. It is a portolio project built in JUCE and HISE, with the DSP in Faust . REACH Extraterrestrial Reverb for Electronic Music. REACH is modern creative Reverb that is made for synthetic sound sources. There are four effects included to transform the Signal. It features modular routing, pre and post filters and over 40 Presets. Part of the DSP code is written in Faust . Stray_virtual-synth A typical wavetable synthesizer will have a table of predetermined amplitude values which are read through at the appropriate speed relative to the frequency of the current note, resulting in an audible signal. Stray functions similarly, reading through a table of values, but the amplitude values are not predefined. Instead, these values are modulated with one of four LFO shapes. The DSP code is written in Faust. Drty Drums A 4 voices drum machine based on FM synthesis [WIP]. The sound engine is made in Faust . 201 Musical Synthesizer We\u2019re Critter & Guitari and we\u2019re happy to announce our newest synthesizer: the 201! If you\u2019re familiar with our other musical instruments such as the Pocket Piano, Organelle, Bolsa Bass, or Kaleidoloop, we hope you\u2019ll see that the 201 fits right in with them: the 201 is fun, portable, and packed with a medley of musical magic! Inside, the 201 uses a combination of Pure Data and Faust musical programming environments. Users are invited to modify or create new sound engines! OneTrick SIMIAN Crash into the 80s with an open source drum synth inspired by hexagonal classics like the Simmons SDS-V . Thumping kicks , punchy snares , and sizzling cymbals coalesce with its clacky claves and crunchy claps . Bring saccharine synthwave sauce to your sublime soundscapes or drop indelable pewww pewww tom toms into your new nu-disco . Get the source code containing Faust DSP , using the Dlang backend. CollisionDrive.lv2 CollisionDrive is modeled after the Horizon Devices Precision Drive, a modern overdrive pedal with a built-in noise gate, with DSP written in Faust . MetalTone.lv2 Distortion Pedal simulation. MetalTone is modeled after the renowned BOSS MT-2 Metal Zone, a high gain distortion pedal with an advanced EQ section, with DSP written in Faust . tamgamp.lv2 Tamgamp (Rhymes with: \"Damage Amp\") is a LV2 guitar amp simulator that provides two plugins, with DSP code developed with Faust : Tamgamp - a plugin based on Guitarix DK Builder simulated chains. TamgampGX - a plugin based on tuned Guitarix internal amplifiers implementation. ReverbZen A Reverb written with Faust and JUCE, based on SchroederReverberators . This reverb effect uses different stages. It splits input signal in parallel and uses different types of delaylines. Different filters are provided to get rid of unwanted resonances. Check out reverb.dsp file to get more detailed insight. Wingie2 Wingie2 is a handheld stereo resonator that you can use as a development platform, and can be programmed with Faust . Slowmo.lv2 A multiband slow gate with delay/echo. The C++ files for the effect are generated from Faust DSP files: Bandsplit.cc , Delay.cc and Volume.cc . Vocoder App Vocoder mobile app for Android made with Faust and its Smartkeyboard interface. This app was developed in the context of a project for the the Real Time Interaction and Performance exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2020). The paper A Faust-built Mobile Vocoder Instrument, included in the repo, provides more information on the algorithm, as well as the description of a case prototype. Echoplex Ep-3 Simulator This archive contains a virtual model of the Echoplex Ep-3 tape delay. The effect has been developed using Faust in the context of a project for the Sound Processing exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2019). The paper Faust Model of the Echoplex Tape Delay, included in the repo, provides more information on the algorithm. faust2smartphone faust2smartphone is a tool to generate interactive musical mobile application embedded Faust API. DPF-Fadeli An experiment with Faust Demo Library content as DPF plugins. Basically glueing a few different projects together, to compile Faust DSP programs in several plugins format: LADSPA, LV2, VST2, VST3, CLAP : DPF faust faustpp faust examples TR8CK TR8CK is an experimental DAW/tracker with Faust live coding via faust2webaudio and UI powered by SolidJS . GuitarD It's a basic multi effects processor which follows a node based approach. Components are developed with Faust . HISE HISE is an open source framework for building sample based virtual instruments combining a highly performant Disk-Streaming Engine, a flexible DSP-Audio Module system and a handy Interface Designer. The implementation of the Faust integration was the result of a Google Summer of Code project done by Roman Sommer with the help of Christoph Hart as mentor. MBStereophony This is a simple implementation of a Regalia-Mitra filter bank using 3rd order Cauer low-pass filters as the base designs. There are four filter bank programs available which are described below. MBStereophony itself is a demo effect that down-mixes a stereo signal separately per frequency band. Audiolab A docker based DSP learning/Experimentation environment including: Jupyter lab FAUST python 3.7 (at the moment. Depends on miniconda3 docker image) FAUSTpy to run FAUST code inside jupyter faustWidgets (to interactively control FAUST code ) librosa (for MIR and feature extraction) scipy, pandas, numpy for general data science sox (encoding, batch processing etc) ffmpeg (encoding batch processing etc) seaborn (more beautiful plots) latex TODO (for exporting jupyter notebooks) LR_Delay A stereo delay plugin which emphasizes free (non beat-synced) controls for the individual channels. Built with Faust and JUCE. Leslie speaker simulator This archive presents a virtual simulation of the Leslie Speaker commonly found in Hammond electric organs. The digital effect has been developed using the FAUST programming language, and then ported into a VST-compatible format using the JUCE C++ framework. cookiecutter-dpf-faust A cookiecutter project template for DISTRHO Plugin Framework ( DPF ) audio effect plugins using FAUST for the implementation of the DSP pipeline. Look at the demo video . DF Zita Rev1 A feedback-delay-network reverb plugin built with DPF and based on a FAUST library demo. Several other projects are developed using the same DPF/FAUST methothodolgy: FAUST filters , a collection of virtual-analog filters from the FAUST standard library packaged as multi-format plugins via the DPF SendMixer , a stereo channel strip plugin with one master gain and two pre/post-fader sends Stereo Cross Delay , a stereo delay plugin with feedback and cross-mixing. Theremotion Theremotion is a virtual instrument inspired by the Theremin. Just like a Theremin, the position of your hand in the air controls the pitch and volume of the sound. However, you can also control much more dimensions of the sound with specific motions. With specific hand positions, you can control a low pass filter, a supersaw sound, a guitar sound and more. You can even make the instrument \"stick\" to a scale, making it much easier to control than a Theremin. The hand tracking is provided by Ultraleap's Leap Motion Controller . The sound generation is created with Grame's Faust . The program is built with Rust . Hypercurve Hypercurve is a library allowing you to combine several curve algorithms into a single 2D envelope. It is designed to be used in audio applications, for people who know how to enjoy a finely shaped curve. As shown above, you can perfectly combine gaussian curve with diocles cissoid curve, and plenty of other curve algorithms. The library can be used in C++, Lua, Csound and Faust . faust-mcp This package provides a Pd abstraction mcp.pd (along with some helper abstractions and externals) which lets you control your Faust instruments and effects more conveniently with control surfaces utilizing the Mackie Control Protocol (MCP). Faust.quark This SuperCollider package makes it possible to create SuperCollider packages (Quarks) containing plugins written in Faust code. With this, you can distribute plugins written in Faust and make it easy for others to install, compile or uninstall them. It also contains some simple interfaces for the faust and faust2sc.py commands used behind the scenes. Komet Komet is a computer music / sound system by Mads Kjeldgaard written in SuperCollider and Faust . Komet is a computer music system that makes advanced synthesis operations and composition easier. It auto generates thousands of synthesizer variations from simple recipes and offers a range of DAW-like features such as effect chains (like on channel strips) and other conveniences. It can work natively in stereo, multichannel or high order ambisonics mode with the flick of a switch, allowing the same compositions to be used in different sound systems. Faug A Minimoog Model D emulation with the DSP portion written in Faust and using JUCE framework. Moog + Faust = Faug. Striso Studio A virtual Web version of the Striso board, using the Faust WebAssembly compiled sythesizer code . Sttera A Software for Audio Recognition and Orchestration as Medium for Music Ritual. Faust WebAssembly library is used internally with the faust2webaudio project. XUiDesigner A WYSIWYG LV2 X11UI GUI creator tool. Provide a easy to use GUI generator tool to create X11 UI's for LV2 plugins. Currently only libxputty is supported, but the generated GUI C file could be used probably with other widget tool-kits as well, just a wrapper file is needed to translate the generated file to the needs of a toolkit. XUiDesigner could now parse faust (.dsp) files and generate a full LV2 Bundle for them. A faust (.dsp) file could be given by the command-line parameter -f or simply by drag it on the Designer window. It will create all control widgets which you could then rework to your needs before you save your Bundle. DSP Speech Processor A Faust based DSP Speech Processor. Based on the Daz DSP v2.1 Speech Processor firmware, with improvements. Compiled into Webassembly format. Runs in a web browser! Squaring Loop Synchronous AM ISB Demodulator This demodulator uses a squaring loop to regenerate the AM carrier from the sidebands during signal fades. This allows it to maintain carrier lock even without a carrier! The squaring loop multiplies the signal with itself, causing a 2F carrier to be generated. Carrier + carrier = 2F. LSB + USB = 2F. eurorack-blocks The eurorack-blocks project allows to develop your own custom Eurorack module for either prototyping or fun in the comfort of your day-to-day IDE with the C++ or Faust language , or using the Cycling '74 Max environment, testing and debugging in a virtual Eurorack environment, and when ready, to auto-magically generate all the needed files to manufacture the eurorack module for you to use in a real Eurorack modular system. AmStramGrame An arts and sciences educational project (STEAM), bringing together services and resources for the educational community. It aims at making abstract scientific concepts more tangible and concrete through musical creation and computer programming. The Gramophone is an audio device/musical instrument specifically designed for the AmStramGrame project. Its various sensors and controllers (e.g., accelerometer, gyroscope, light sensor, etc.) make it react to the user's gestures. Its rechargeable battery offering approximately five hours of autonomy and its powerful speaker make it independent from any computer, bringing it closer to traditional acoustic musical instruments. DSP programs are coded in Faust . Additional examples can be found in GramoCollection . GameLAN GameLAN is a set of musical applications designed by Grame , National Center of Musical Creation. They are based on Faust technology and have been designed to be played using only the movements of the smartphone. No musical prerequisite, only your gestures will make you a musician! Screamer Version 1.0 is the accurate Faust reproduction of a VST plug-in written in 2003. In later versions, the parameter ranges is modified and some new functionality are added. This signal mangler features a weird kind of overdrive (see source code for exact formula), a hard-clip distortion, LFO-modulated bit reduction and the possibility of calculating the modulo of a signal. Typebeat Typebeat is a virtual groovebox that\u2019s entirely keyboard-operated. Typebeat draws inspiration from two computing environments. Effects are developped in Faust then generated as Rust modules . AFDN-reverb (High-Order) Ambisonics Feedback Delay Network Reverb. Code is developed in Faust and Max. Karpsichord A virtual harpsichord based on Karplus-Strong string synthesis, implemented in Faust and running in the Web . Arduino Audio Tools Some basic header-only C++ classes that can be used for Audio Processing provided as Arduino Library. A simple Interface class to use Faust with Arduino Audio Tools is provided . Code can be written using Faust . Organelle The Organelle makes it easy to explore new sounds and experiment with new ways of making music. It combines playful and intuitive controls with a powerful and flexible sound engine. The result is an instrument that is limitless in musical possibility and a joy to play. At the heart of the Organelle's sound engine is a robust computer that runs patches. A patch allows the instrument to take on different forms. Onboard hardware for sound input and output and mappable knobs, keys and buttons enable patches to synthesize, sample, effect, and anything in between! The Organelle can be programed with Faust as explained here and with this PD external using Faust . Zrythm Zrythm is a digital audio workstation designed to be featureful and easy to use. It offers streamlined editing workflows with flexible tools, limitless automation capabilities, powerful mixing features, chord assistance and support for various plugin and file formats. A set of Faust effects are compiled as LV2 plugins and included in the application. Patches for the OWL Pedal/Eurorack Module This is a collection of patches written or ported specifically for the OWL. Most of them were written using FAUST and if you want to modify them you'll need to have a working FAUST installation. C++ source code (the .hpp files) for the OWL can be generated by running the \"updateFaustPatches.py\" python script. Then you will need to rebuild the OWL firmware and upload it to the device. Kiwi Kiwi is a graphical programming environment dedicated to music and sound creation, such as Max or Pure Data softwares, but offering a real-time collaborative approach: Kiwi allows several distant users to work simultaneously on the same patch hosted online. Kiwi is part of the French ANR-funded MUSICOLL project that unites the CICM and OhmForce. The main goal of this project is to study how collaboration can enhance the way digital audio music composition is taught and more generally how it can renew music creation practices and improve its workflow. Faust DSP programs can be dynamically compiled as objects included in the patch. An extended presentation of the system can be found in this IFC 2020 paper . Brainwave Virtual Instrument The Brainwave Virtual Instrument (BVI) is an open-source software synthesizer built in the programming language Faust. Its purpose is to facilitate the exploration of electroencephalogram (EEG) and other brain data through sonification. Pre-recorded data is translated as parameter controls of the instrument in the form of Open Source Control (OSC) messages that are generated and streamed by a small python program. The instrument can easily be distributed and compiled to different targets thanks to Faust\u2019s flexibility. Frequency Modulation synthesis provides a comprehensive approach to textural parameters of sounds, so that musical composition and improvisation based on a creative use of brain data become feasible. This is exemplified by the Brainwave Etudes (BE), a series of compositions inspired by measurements of brain activity during different states of mind. The BVI was created for two major purposes: on the one hand, to find musical structures that relate to each other in order to present an aesthetic proposal, and on the other, to create a tool that familiarizes scientists and researchers in the field of neuroscience with sonification techniques, and the exploration of brain activity through sound. An extended presentation of the system can be found in this IFC 2020 paper . Mephisto Mephisto is a transpiler for converting sound patches designed using the graphical computer music environment Pure Data to the functional DSP programming language Faust. Faust itself compiles into highly-optimized C++ code. The aim of the transpiler is to enable creating highly optimized C++ code embeddable in games or other interactive media for sound designers, musicians and sound engineers. weather_organ Weather Organ is a Faust instrument for manipulating sparse noise to imitate slowly-changing natural sound sources such as rain, wind, surf, fire, Geiger counters and volcanic activity, and to create interesting new textures of sound. It is the product of various discoveries made while using Faust to explore the definition, synthesis and experience of acoustic noise while, simultaneously using the exploration of noise as as focus for learning Faust. Genius Eurorack Module The Genius is the next evolutionary step for the OWL platform, and the first product released based on a Cortex M7 microcontroller. It runs the OWL firmware and so can be programmed with Faust. A demo running bells from thee physical library can be listened to here . Dataflow Based FPGA Program Synthesis A Yale-NUS BSc. (Hons) in Mathematical, Computational, and Statistical Sciences Capstone: an FPGA Program Generator written in Python that takes dsp-sig XML Dataflow Graphs created using FAUST to produce FPGA programs in VHDL. DSPedal DSPedal is a custom hardware platform for real-time sound effects. It is operated by few knobs, external expression pedal, couple of buttons and a small graphical LCD. Processing effect is written in Faust programming language and compiled into C code. So far the Cortex M4 core clocked at 204 MHz has proven to be capable of executing relatively complex effects like wah, but effect-chaining quickly reaches the limits of processing power. Tambura Waveguide physical model of an Indian Tambura/Tanpura. This is a FAUST patch inspired by the Indian Tambura/Tanpura - a four string drone instrument, known for its unique rich harmonic timbre. The model uses a few tricks to produce a Tambura-like sound, and should probably be referred to as a \"pseudo\" physical model, because it does not attempt to accurately recreate the physics of the string-bridge interaction. It includes a range of parameters selected to allow control of the qualities of the excitation/pluck, string behavior and sympathetic resonance. It can produce some beautiful evolving drones, which can vary from very synthetic to quite natural. The model can be tested here . drumbox drumbox is a fun and powerful drum synthesizer for your Android device. Start from a preset and tweak the sounds and appearance to make it your own. Freestyle on the drum pads, record a sequence or both...it's up to you! Granola Granola is a monophonic granular live feed processor. The grain processor is inspired by the Mutable Instruments Beads. The grain window shape control is inspired by the GR-1 Granular synthesizer from Tasty Chips Electronics. The DSP code is written in Faust. fverb A stereo variant of the reverberator by Jon Dattorro coded in Faust. Sonification This study has been developed as a proof-of-concept for data pattern sonification. We've implemented data pattern sonification using FM synthesis coded in Faust. Air pollution data, which is temporal, is retrieved from the server and is done pattern mining. Then pattern data sonification is done. GULA Plugins A collection of guitar effect LV2 plugins ( The Vibey , The Splits , The Fades , SSaP Tone , Sweabed , Pequed , Peak audio to CV , LFO CV ) with MOD Devices user interfaces. limiterStereo Yet another look-ahead limiter code in Faust. The novel aspect of this limiter is that it uses N cascaded one-pole filters for amplitude profiling, which improves smoothness in the first to N-1 order derivatives and reduces total harmonic distortion. This design uses four cascaded one-pole lowpass filters, following the cut-off correction formula (8.9) found in [Zavalishin 2012]. Web Audio Modules Web Audio Modules are an open source framework facilitating the development of high-performance Web Audio plugins (instruments, realtime audio effects and MIDI processors). They can be developed using JavaScript and Web standards or compiled from C, C++ code, and domain-specific languages such as Faust or Csound. The Faust Web IDE contains an integrated GUI builder, read a tutorial here . Kapitonov Plugins Pack Set of 7 plugins for guitar sound processing, compiled in LADSPA and LV2 formats. Compatible with hosts such as Ardour, Qtractor, Carla, guitarix, jack-rack. The DSP of all of them is written in Faust. tubeAmp Designer Standalone software guitar processor, editor of *.tapf profile files for tubeAmp (KPP) and guitar amp profiler. BioSignals BioSignals is a data aquisition and processing device for EMG, ECG and EEG signals. Since it is using the OpenWare firmware, it can be programmed with Faust. Scale it Scale it is an open source program (written in graphical programming language Pure data and in Faust) that allows sonification of a signal distribution in real time. There are two different possibilities of sonification of the signal. One of the objects, tone, generates changes in pitch of a monophonic tone. The other object, chord, expresses the input value in width of polyphony. Scale it is being developed primarily for neurofeedback purposes. To allow straightforward and customizable instruments to carry sonic feedback about EEG activity in specific regions of the neocortex. JackTrip JackTrip is a Linux, macOS, or Windows multi-machine audio system used for network music performance over the Internet. It supports any number of channels (as many as the computer/network can handle) of bidirectional, high quality, uncompressed audio signal streaming. Several DSP effects ( compressor , freeverb , zitarev , limiter ) are written in Faust, compiled as C++ code, and included in project sources . Level Rider This is an audio plugin written in Faust that automates gain level adjustments, based on a target gain level, a time window over which overall loudness is calculated via RMS, and a maximum adjustment threshold. This plugin is comparable to Waves Vocal Rider or Waves Bass Rider in its functionality, but is free and open-source. Whetstone Transient Shaper A free, open source transient shaping audio plugin that operates on a specified frequency band. Whetstone will extract a certain frequency band based on a low cutoff and high cutoff that you choose, apply transient shaping to it, and then reintegrate the shaped band back into the original signal. This plugin is meant to be comparable to the excellent Spiff plugin in its core functionality, but lacks many of the nice features and polished UI. The DSP is coded in Faust . Reverb Trickery A free, open source audio plugin implementing various creative reverb effects, including octave-shifted, distorted, hi-pass/low-passed, gated, and narrowing reverb, coded in Faust . b259wf This is a model of the \"tibre\" circuit of the Buchla 259 Complex Wave Generator, made in Faust . The model follows the circuit modelling as seen on the paper Virtual Analog Buchkla 259 wavefolder , using 5 folds. The proposed 2-point BLAMP antialiasing method has been attempted for arbitrary sources as shown here , but it is not sufficient for high frequencies and/or more complex signals. Instead, filtering and light cubic nonlinearity distiorion has been used to round corners and for clipping. The user interface consists of the controls fold for the folding amount, offset for offseting the signal before folding, and lowpass as a final stage one-pole filtering to control the character (too much folding might introduce unwanted higher harmonics for certain signals). The final output is dc-blocked. string-machine This is a virtual-analog string ensemble synthesizer. The implementation is based on a digital model designed by Peter Whiting. The improvement of the model adds various abilities, in particular a virtual-analog emulation of the bucket brigade delay circuit. Most of the DSP code is developed using Faust. Three VST or LV2 are generated: string-machine , string-machine-chorus and string-machine-chorus-stereo . metaFx The metaFx is a control surface for continuous sound transformations in real time, just like the metaSurface64. Like metaSurface64 , it has both its own loop generator and a multi-effects FX engine, but its operation is different, especially for the management of plugin chains and pads. Each mixer on this surface can directly control the gain and the attached plug-ins. It is also possible to control the tracks of an external sequencer (Ardour or Reaper). To do this, the application uses OSC controllable modules that come from the Faust language library that is embedded in the application. Its interest lies in the construction of a parallel sound processing chain in the form of a graph. Kymatica.com Jonatan Liljedahl at Kymatica AB makes iOS music apps, electronic music, and a little bit of audio hardware. The following iOS applications have DSP code developed using Faust: AU3FX:Push : AUv3 dynamics processor with noise gate, compressor/expander with external side-chain input, brick-wall look-ahead limiter and hard/soft clipper. AU3FX:Space : High quality tweakable AUv3 reverb with resonant filters. For everything between small rooms, resonators, and infinitely large spaces. AU3FX:Dub : Stereo AUv3 delay effect for everything from clean digital delays to filthy dub echoes, ping-pong flangers, and broken cassette tapes. AUFX:PeakQ : A versatile 4-band parametric stereo equalizer for everything between subtle frequency enhancements and agressive boosting/cutting or special resonator effects. Nemesis Nemesis is multichannel dsp platform for eurorack. It can be programmed with Faust . Sonobus SonoBus is an easy to use application for streaming high-quality, low-latency peer-to-peer audio between devices over the internet or a local network. Several DSP effects ( Compressor , Expander , Limiter , ParametricEQ , Reverb ) have been written in Faust , compiled as C++ code, and included in the JUCE project . XPlugs.lv2 This repository contain the LV2 plugins developed using libxputty/XUidesigner. The included makfile allows the build of all plugins against a single checkout of libxputty. Each plugin exists as its own submodule under this repository. Some of the DSP code has been written with Faust. Bass Preamp Drive The goal of this project is to digitally reproduce the behavior of a well-known electric bass preamp: Ampeg SVT3 Pro. This preamp has been copied by several manufacturers. So we have an almost perfect copy with the Bugera BVP5500 which has four preamplifier tubes. An analog copy is also available as a pedal, the Tech 21 BDDI. The project is based on advances in the simulation of analog circuits made available by the Guitarix project and the excellent Faust from Grame cncm. Drum Module This project aims at integrating a digital drum synthesizer using Faust and Miosix real time OS on an STM32F407VG Discovery Board. To do this, a user interface by means of buttons, sliders, encoders, and an LCD has been implemented to control the synthesizer. Moreover, a serial MIDI input port has been added in order to control the synthesizer externally by using an external sequencer or controller. Daisy based audio boards Daisy is an embedded platform for music. It features everything you need for creating high fidelity audio hardware devices. Just plug in a USB cable and start making sound! No soldering required. It can be programed with Faust using the faust2daisy tool. Elk Audio OS Elk is an Audio Operating System developed from the ground up to deliver real time audio performances in embedded systems and remote networks. It can run on several hardware . Faust can be used to generate VST2 plugins to run on the plaform. ER-301 Sound Computer The ER-301 is a voltage-controllable canvas for digital signal processing algorithms. It can be programed with Faust using the faust2er301 tool and some units are developed here . Note that it is still a WIP, read the discussion here . Zynthian platform Zynthian is a new class of musical device. A powerful multitimbral synthesizer and audio processor, capable of managing up to 16 audio chains simultaneously. Also, it's a MIDI processor and router, equipped with standard MIDI ports, USB, WIFI & wired networks. Zynthian is a community-driven project and it's 100% open source. The Zynthian platform can be programmed with Faust with some DSP examples here . GxPlugins.lv2 GxPlugins.lv2 is a set of more than 40 extra standalone lv2 plugins designed to compliment the Guitarix project. Each plugin exists as its own submodule under this repository. The DSP code has been written with Faust. Stone phaser A classic analog phaser effect. This is an analog phaser with similarity to the Small Stone. It has a color switch, which makes the phasing stronger when on, and adds some feedback controls. A stereo variant of the phaser is included. This effect is supported on MOD devices. The DSP code is developed in Faust . sfizz sfizz is a sample-based musical synthesizer. It features the well-established SFZ instrument format at its core, which permits to use existing instrument libraries, or create personal instruments with ease. Not only is sfizz ready-to-use as an instrument plugin of its own, the library allows developers to create instruments of their own, taking advantage of the abilities of SFZ. The sfizz project uses the SFZ parser and synth c++ library, providing AU / LV2 / VST3 plugins and JACK standalone client. Some effects are developed in Faust are well as several filters . Antescofo Antescofo is a coupling of a real-time listening machine with a reactive and timed synchronous language developed at IRCAM . The language is used for authoring of music pieces involving live musicians and computer processes, and the real-time system assures its correct performance and synchronization despite listening or performance errors. Antescofo audio DSP processes can be described with Faust , using libfaust dynamic version of the Faust compiler. Motion Vox A mobile music creation and performance workstation with a built-in motion-based controller, sequencer and synthesis engine. The controller unites XY pad, accelerometer and gyroscope events with complex data \ufb01ltering engine. Performance process consists of touching the active area on the screen with the index finger and moving the cursor while moving the device in space. Smartphone position in space and finger movement on a screen affect various parameters of sound or generate realtime MIDI output. The app was inspired by the SmartFaust project of GRAME. The audio engine of the app is made with FAUST. INScore INScore is an open source framework for the design of interactive, augmented, live music scores. Augmented music scores are graphic spaces providing representation, composition and manipulation of heterogeneous and arbitrary music objects (music scores but also images, text, signals...), both in the graphic and time domains. Audio DSP processes and effects can be described using Faust. The environment runs as a native application but also in the Web. Faust programs are only supported by the online version . Virtual Rhizome By Vincent Carinola . Virtual Rhizome responds to a proposal by Christophe Lebreton and Jean Geoffroy to compose a work for the original Smart Hand Computer system, developed at the GRAME-CNCM using the Faust language and allowing to play smartphones as an instrument. The work takes the form of a labyrinth, a kind of virtual architecture that could be compared to Borges' \"garden of branching paths\", within which the musician evolves by adapting his gestures to the constraints of different types of situations. Each situation is characterized by an autonomous functioning of the system, that the musician must apprehend in order to find the key allowing him to modify it and to move towards another situation. But in order to orientate himself well, he must create a mental representation of the structure of the work. The performer then becomes an explorer of a world that he unveils, but isn't that what he has always been? Virtual rhizome owes much to the availability and enthusiasm of Jean Geoffroy and Christophe Lebreton. It is amicably dedicated to them. SmartFaust SmartFaust is a concept of musical applications for smartphones. These applications have the particularity of only using the user's gestures and not by tapping on the device's screen. Made for iOS and Android, they can also use the motion sensors of these devices to make them real musical instruments. Smartfaust applications are based on the Faust (Functional Audio Stream) programming language developed by Grame over the last 15 years and recognized as a standard in the field of real-time signal processing for audio. The SmartFaust applications were first used for the creation of the pieces Mephisto (for drums and cell phone ensemble), Belzebuth (participative piece for public equipped with Smartphones), Iblis (for clarinet and cell phone ensemble) and B\u00e9lial (for harp and cell phone ensemble) written by the composer Xavier Garcia. From this same technology were later created the applications \"Geek Bagatelles\" (2016) and \"GameLan\" (2019). Download here: Android & iOS Trombone Simulator This simulator is a physical model of a trombone. Physical models of the lips, mouthpiece, slide, and bell are digitally simulated. The controls are listed at the top. The main controls are to move the cursor (or your finger on a touch device) left and right on the picture to adjust the embouchure, and up and down to extend and retract the slide. The diagonal colored lines are a guide to where the resonances are: playing over a resonance means that the embouchure and slide length are matched. Playing over white space means that one is between resonances and the note quality won't be as good. The big gray wedge on the upper right indicates that the resonances are very close together there. The vertical dashed lines indicate the rough locations of B-flat (thick lines) and F (thin lines). Other notes are unmarked, and likewise the slide positions. (Just like on a real trombone!) The off-key resonances (7th, 11th, 13th, and 14th) are marked in red. The g and f keys can be used to growl and flutter-tongue, respectively. The audio simulation is written in Faust, which conveniently compiles to WebAssembly and a Web Audio API wrapper. The overall approach used was a digital waveguide model, as described in J. O. Smith III's Digital Waveguide Theory. The lips and bell are adapted from F. Scott's masters thesis. Integrating 1-DoF force feedback interactions in self-contained DMIs By Mathias Kirkegaard . This thesis presents a system for designers of Digital Musical Instruments (DMIs) to explore the integration of 1 degree of freedom (DoF) force feedback interactions in new self-contained instruments. The system developed consists of an open-source graphical tool and a rotary force-feedback device made from commercially available components to facilitate the authoring of audio-haptic applications. Implementing an early prototype is used to inform the development of the graphical editing tool and its integration in an embedded audio-haptic environment using the functional programming language Faust for real-time signal processing. Beyond Key Velocity: Continuous Sensing for Expressive Control on the Hammond Organ and Digital Keyboards By Giulio Moro . In this thesis we seek to explore the potential for continuous key position to be used as an expressive control in keyboard musical instruments, and how pre- existing skills can be adapted to leverage this additional control. The nonlinear waveguide physical model of a flute has been developed in Faust. Guide de la synth\u00e8se sonore By Sebastien Clara . In this guide, I try to demystify how sound synthesis works. To do so, I present the fundamental principles of sound synthesis. I accompany these explanations with small sound applications that you can manipulate in your web browser and thus, you will be able to notice the impact of a parameter on the sound. Most of the sound examples are written in Faust and run in the web pages. This guide is currently only in french. PICO DSP PICO DSP is an open-source, Arduino-compatible ESP32 development board for audio and digital signal processing (DSP) applications. It offers an expansive audio-processing feature set on a small-format, breadboard-friendly device that provides audio inputs, audio outputs, a low-noise microphone array, an integrated test-speaker option, additional memory, battery-charge management, and ESD protection all on one tiny PCB. The board can be programmed using Faust . Soundjack The Soundjack realtime communication application is extended by a server cloud to handle up to 60 musicians of an orchestra, developed with the Faust programming language. Each musician is connected to a Soundjack UDP client. An individual stereo mix of the multiple audio streams originating from the multiple Soundjack clients has to be provided to each listening musician. An extended presentation of the system can be found in this IFC 2018 paper . studiox-switcher Studiox-switcher is an input switcher and silence detector for JACK. It can switch between 3 stereo inputs, a fallback channel is activated if the active input is below a volume threshold for some amount of seconds, and channels may be switched via OSC and HTTP. The core DSP engine is done via Faust for switching, silence detection and level metering. SynthSpace Synthspace is the ultimate virtual synthesizer. It combines the familiarity of real instruments with the possibilities of virtual worlds. Nodes for Synthspace can be developed in Faust . Bass21 This VST3 is a virtual-analog simulation of the famous Bass Driver DI Version 1 preamp pedal from Tech21. The discretization, while far from being exact, is moderately close to the original. The potentiometers are identical to these physically present on the BDDI pedal, apart from the pregain which is specific to this digital version. The DSP code is written in Faust. EchoMatrix The EchoMatrix was designed to provide some of the functionality of the Yamaha UD Stomp pedal as used be Alan Holdsworth. This project will be submitted to the KVR Developer Challenge 2021 contest to highlight the power of the Faust DSP development environment and the JUCE framework to create a non-trivial effect VST3 using a managable amount of Faust DSP code . The Striso board The Striso board is a very expressive music instrument which combines multidimensionally sensitive keys with an innovative note layout that helps understand the structures in music. The keys capture each subtle finger movement, which allows for levels of musical expression previously only known to acoustic instruments. Additionally, accents and sound effects can be added by shaking and moving the instrument as a whole. The internal sound is written in Faust, and is controlled directly by the signals from the keys and motion sensor. External synthesizers can be controlled using MPE MIDI, or using OSC which is easier to set up for Faust synthesizers. The firmware source code is released as open source. Live concatenative granular processing This algorithm addresses signal discontinuity and concatenation artefacts in real-time granular processing with rectangular windowing. By combining zero-crossing synchronicity, first-order derivative analysis, and Lagrange polynomials, we can generate streams of uncorrelated and non-overlapping sonic fragments with minimal low-order derivatives discontinuities. The resulting open-source algorithm, implemented in the Faust language, provides a versatile real-time software for dynamical looping, wavetable oscillation, and granulation with reduced artefacts due to rectangular windowing and no artefacts from overlap-add-to-one techniques commonly deployed in granular processing. fb_suppression ALS - Automatic Larsen Suppression algorithms implementing adaptive filtering through spectral centroid calculation, and adaptive frequency shifting through RMS calculation. ossia score Ossia score is a sequencer for audio-visual artists, designed to enable the creation of interactive shows, museum installations, intermedia digital artworks, interactive music and more in an intuitive user interface. Faust can be used to create advanced audio processes . A demo video of the Faust integration can be seen here . FASELUNARE Microcosmos Microcosmos is a small open-source electronic board, developed by \u200bFaselunare (Italy), aimed at prototyping electronic musical instruments and learning electronics, microcontroller programming and audio DSP, and programmable with Faust. A demo video of the project can be seen here . The project has been presented at ADC21 . Audio Anywhere The goal of Audio Anywhere is to explore the idea of compile once, run anywhere for audio DSP code. Audio Anywhere combines Faust, for audio DSP code, and HTML5 to enable development of modern audio synthesis and effects tools. There are currently three main repos for this work: AA examples AA standalone app AA Wasmtime runtime The KeyWi An Expressive and Accessible Electronic Wind Instrument, where the sound is synthesized with Faust running on the Bela Mini processing board. React Web Audio Guitar Studio React Web Audio Guitar Studio is an online real-time Web Audio based all-in-one guitar studio, using native plugins written on Faust, compiled on-demand, and ran in a browser. JSPatcher JSPatcher is a Visual Programming Language (VPL) in Max/PureData style on the web with following features: Patch WebAudio native AudioNodes Play with JavaScript Web APIs Import and patch external JavaScript modules Customize AudioWorklet DSPs with Faust A presentation video can be seen here . Gwion Gwion is a programming language aimed at making music. It is strongly inspired by ChucK and can use a set of plugins for Gwion . One allows to use the libfaust library to JIT compile and run DSP code on the fly. The faust2gw tool allows to produce statically compiled modules. sonejostudios A set of tools written using Faust. Panoramix Stereo Panorama/Balance and Volume Automation Tool. Mixer4x A simple 4-channel stereo mixer. The main goal is to use it as a submixer on a 4 channel track, but you can use it everywhere you need a small 4 channel stereo mixer. faustdrumseq A very simple drum sequencer written with Faust, using the new soundfile object. MidiClockClick A simple metronom driven by MidiClock. SuperBeatRepeater Beat Repeater with Sidechain Beat Recognation and Midi-Clock Sync. Very useful i.e to add musical diversity by looping short parts of the stream (i.e drums). SuperCutSequencer Cut \"On/Off\" Sequencer (8 steps with smooth) synced to Midi-Clock Beats and Midi-Clock Start/Stop. Very useful i.e to add musical diversity in looped tracks (very nice with i.e bass lines). DeLooper Sample-accurate Looper/Delay with free mode and midi-clock sync mode. XYMatrix XY Surround Matrix for one Source (Mono Input) with 4 Outputs (Left, Right, Surround Left, Surround Right) and Position Lock. stm32-faust-synth STM32 synthesizer video is a short presentation of a polyphonic synthesizer based on STM32F405 \u00b5C. Faust is used for signal processing and a TLV320AIC23B stereo codec serves as DAC. Another more recent video is here . faustgen2~ The faustgen2~ object is a Faust external for Pd a.k.a. Pure Data , Miller Puckette's interactive multimedia programming environment. Amati Amati is a VST plugin for live-coding effects in the Faust programming language. As of now it only provides basic functionality. PureTones PureTones PureTones is a family of software tools for Indian Classical music. They are built based on an in-depth study and exploration of Indian Classical music to understand the role of harmonics, microtones and consonance in Indian Ragas and musical scales: PureTones Drone (using first tab) , is a digital Tanpura with controls for fine tuning the strings and adjusting their harmonic envelope. PureTones Musical Scale (using second tab) is a digital 12 note keyboard with controls for fine tuning each key to be consonant with an accompanying drone track. PureTones Sequencer (using third tab) is a sequencer which enables composition of melodies and musical works in Indian Classical music using notes from a fine tuned musical scale. The Ragatronics project combines Ragas from Indian Classical music with elements from Rock, Jazz and Electronic music. All applications have been developed using Faust and WebAudio tools. Making Sound Machines Making Sound Machines are a duo of makers from D\u00fcsseldorf, Germany. We build kits, modules and DIY projects, and use the projects we\u2019ve built to make music. Faust is used in several projects. master_me Automatic audio mastering plugin for live-streaming, podcasting and internet radio stations. With the first Covid-19 related lock-downs in 2020, many real-life concerts, conferences and festivals were forced into the digital domain - and sounded pretty crappy. Having worked for almost 20 years in audio mastering, Berlin based engineer Klaus Scheuermann started to develop master_me - a word fusion of automatic mastering and mini-me - in order to make open source streaming sound better. After a few weeks of learning and development, master_me was first used at the 'Quarantine Sessions' - a weekly distributed electro-acoustic improvised concert, hosted at Stanford's CCRMA Institute. master_me was developed further to be an easy-to-use tool for all live streaming applications. In 2022 it was funded by the Prototype Fund, an open source software funding initiative by the german ministry of education and research. A stable release is available since September 2022. metaSurface64 metaSurface64 is a real-time continuous sound transformation control surface that features both its own loop generator for up to 64 voices and a multi-effects FX engine. The application embeds the libfaust dynamic version of the Faust compiler. Fragment Audio Server and Fragment Fragment Audio Server (FAS) is a high performance pixels-based graphical audio synthesizer implemented as a WebSocket server with the C language (C11). Faust , is embedded (when compiled with WITH_FAUST ) and allow to dynamically extend FAS bank generators and effects with custom one written with the Faust DSP specification language. FAS is the audio engine used in Fragment , the Collaborative Graphical Audio Synthesizer. Follow the demo here . Swanky Amp Swanky Amp is a tube amplifier simulation DSP plugin which aims to capture the details in the dynamics of tube amplifiers. The DSP is primarily written in Faust , whereas the UI is written in C++ using the JUCE . Follow the demo here . A commercial version is available here . Web Synth This is a web-based DAW (Digital Audio Workstation) written in Rust/WebAssembly and TypeScript with extensive Faust language integration with dynamic remote code compilation and executing via WebAssembly. Follow the demo here . DawDreamer DawDreamer is an audio-processing Python framework supporting core DAW features such as audio playback, VST MIDI instruments, VST effects, Faust , and parameter automation. DawDreamer is written with JUCE , with a user-friendly Python interface thanks to pybind11 . DawDreamer draws from an earlier VSTi audio \"renderer\", RenderMan . TD-Faust TD-Faust enables Faust code to run inside TouchDesigner . Follow the demo here . Mephisto LV2 Mephisto LV2 a Just-in-Time Faust compiler embedded in an LV2 plugin. Write LV2 audio/cv instruments/filters directly in your host in Faust DSP language without any need to restart/reload host or plugin upon code changes. iPlug2 iPlug 2 is a simple-to-use C++ framework for developing cross platform audio plug-ins/apps and targeting multiple plug-in APIs with the same minimalistic code, support for the Faust programming language, and the libfaust JIT compiler. pMix pMix (short for preset mixer) is a sound design, composition and performance tool that facilitates the control of multiple parameters using an intuitive graphical interface. It includes a graphical patcher for creating a network of audio synthesis or processing nodes. A node could be a VST2, VST3, AU or LADSPA plug-in or it could a JIT compiled FAUST script. FAUST is a first class citizen in pMix and an integrated code editor and SVG display makes it a nice environment for FAUST development. Temper JUCE plugin Temper is a digital distortion audio plugin targeting VST, VST3, and AU for OS X and Windows. It builds upon traditional waveshaping techniques using modulated filter coefficients to produce a unique phase distortion. The primary signal processing loop is written with Faust, and compiled with JUCE for the various build targets. Faust Mass-Interaction mi_faust implements 1D mass-interaction models in the FAUST programming language. Starting from a scripted model description (see MIMS), mi_faust compiles a physical model into FAUST code. It handles this by generating routing functions between all the masses and all the interactions in the model. Head over to the FAUST community page to see examples of a series of instruments created in mi_faust, and available as web-apps ! Dynamic PedalBoard Dynamic PedalBoard allows users to plug different stompboxes together in a web browser. SHARC DSP Board The ADI SHARC DSP board fully supports Faust. Nuance Nuance is a pressure sensitive music controller that uses Faust for sound synthesis and processing. The PlateAxe The PlateAxe is a percussion instrument physical model controller using Faust for sound synthesis and processing. The BladeAxe The BladeAxe is an electric guitar physical model controller using Faust for sound synthesis and processing. Bart Brouns' Projects A collection of projects by Bart Brouns and based on Faust. EarTone Toolbox The Ear Tone Toolbox is a collection of unit generators for the production of auditory distortion product synthesis. AudioKit AudioKit allows developers to quickly add professional audio functionality to iOS, macOS, and Apple Watch apps. Radium Radium is a music editor with a new type of interface. It includes a Faust audio DSP development environment. Compared to the normal sequencer interface editing is quicker and more musical data fits on the screen. Compared to trackers, note positions and effects are edited graphically, which should be quicker, provide more vertical space and give a better musically overview. (Everything can also be edited by text, like in a normal tracker) Radium can also be used as a normal multitracker to mix and record audio. BELA Bela is a maker platform for creating beautifully responsive audio and interactive applications. Designed for artists, musicians, researchers and makers, Bela brings the power of ultra-low latency interactive audio and sensors to your digital projects. It can be programmed with Faust . HOA Library HOA Library allows musicians and composers to synthesize, transform and render sound fields in a creative and artistic way. This library facilitates the understanding and the appropriation of key concepts of ambisonics. Thanks to original graphical interfaces a lot of new signal processings are allowed like diffuse sound field synthesis, perspective distorsion or spatial filtering. HOA library is open-source and free and offers a set of C++ and FAUST classes and implementation for Max, PureData and Unity. Ambitools Ambitools is a collection of plug-ins and tools for 3D sound field synthesis using Higher Order Ambisonics (HOA). The plugins are written in the Faust language , which allows them to be compiled for a multitude of architectures and platforms (Windows, Mac, Linux, WebAudio, embedded systems, etc.) Moreover, the code is written in a scalable way: there is no limit to the maximum Ambisonic order! Other tools are also available, such as a 3D Visualizer written in the Processing language. Ambisonic Decoder Toolbox The Ambisonic Decoder Toolbox is a collection of MATLAB and GNU Octave functions for creating Ambisonic Decoders. Currently, it implements: (1) the AllRAD design technique, (2) inversion or mode-matching, (3) truncated mode-matching, constant energy, (4) linear combinations of 2 and 3, and (5) Slepian function basis (EPAD). The DSP code is written in MATLAB and Faust. Ambisonic.xyz A set of tools around Ambisonics. FaustPy FaustPy is a Python wrapper for Faust. It is implemented using the CFFI and hence creates the wrapper dynamically at run-time. Rebel Technology The OWL Pedal is an open source, programmable stage effects pedal, made for guitarists, musicians, hackers and programmers. Users can program their own effects, or download ready-made patches from our growing online patch library. faust-vst This project provides a VST plugin architecture for the Faust programming language. The package contains the Faust architecture, faustvst.cpp, the faust2faustvst helper script which provides a quick way to compile a plugin, a collection of sample plugins written in Faust, and a generic GNU Makefile for compiling and installing the plugins. faust-lv2 This project provides an LV2 plugin architecture for the Faust programming language. The package contains the Faust architecture and templates for the needed LV2 manifest (ttl) files, a collection of sample plugins written in Faust, and a generic GNU Makefile as well as a shell script to compile plugins using the architecture. RDK Reverb Design is about creating a spacial impression aimed at sweetening the listening experience for a given context. The ambiguity of auditory and visual cues in reproduced sound makes it necessary to create an auditory illusion: To make this illusion work, I propose an aesthetic concept of simplicity and intelligibility based on psychoacoustic facts and recording practice as professional producer. Foo YC20 The Foo YC20 is an open source implementation of the Yamaha YC-20 combo organ from 1969. Processing for the organ is based on original schematics and measurements from a working specimen. This instrument simulates the circutry as a whole to realisticly reproduce the features and flaws of the real deal. FaucK FaucK is a Chugin allowing to combine the powerful, succinct Functional AUdio STream (Faust) language with the strongly-timed ChucK audio programming language. FaucK allows programmers to on-the-fly evaluate Faust code directly from ChucK code and control Faust signal processors using ChucK's sample-precise timing and concurrency mechanisms. The goal is to create an amalgam that plays to the strengths of each language, giving rise to new possibilities for rapid prototyping, interaction design and controller mapping, pedagogy, and new ways of working with both Faust and ChucK. Snd-RT Snd-RT is the realtime extension for the sound editor SND and consists of two parts: the RT Engine - An engine for doing realtime signal processing. the RT Compiler - A compiler for a scheme-like programming language to generate realtime-safe code understood by the RT Engine. Pure Language [Pure is a modern-style functional programming language based on term rewriting. It offers equational definitions with pattern matching, full symbolic rewriting capabilities, dynamic typing, eager and lazy evaluation, lexical closures, built-in list and matrix support and an easy-to-use C interface. The interpreter uses LLVM as a backend to JIT-compile Pure programs to fast native code. It has been created by Albert Gr\u00e4f. pd-faust is a collection of Pd objects written using pd-pure which lets you run Faust programs inside Pd. It combines the functionality of pure-faust and faust2pd in a single package, and also features dynamic reloading of Faust plugins, automatic generation of controller GUIs and MIDI/OSC controller mappings, as well as OSC-based controller automation. It thus provides a complete solution for interactively developing Faust dsps in Pd. Guitarix An audio plug-in for guitar effects whose sound processing engine is written in Faust. moForte GeoShred An electric guitar app using physical modeling. Faust was used to implement its sound synthesis/processing engine. moForte PowerStomp An app implementing various guitar effects to be used on stage. moForte Guitar An app that can be used as an electric guitar and whose sound synthesis engine is implemented in Faust. FaustWorks FaustWorks is an IDE (Integrated Development Environment) for the Faust dsp programming language. You must have Faust installed to be able to use FaustWorks. Platforms supported are Linux and OSX. FaustLive FaustLive is an advanced self-contained prototyping environment for the Faust programming language with an ultra-short edit-compile-run cycle. Thanks to its fully embedded compilation chain, FaustLive is simple to install and doesn't require any external compiler, development toolchain or SDK to run. FaustLive is the ideal tool for fast prototyping. Faust programs can be compiled and run on the fly by simple drag and drop. They can even be edited and recompiled while running, without sound interruption. It supports also native applications generation using the Faust online compiler. FaustLive is based on the Faust library and on LLVM. \u200b","title":"Powered By Faust"},{"location":"community/powered-by-faust/#powered-by-faust","text":"This page lists the projects using Faust in different ways: musical pieces or artistic projects, plugins or standalone applications, integration in audio programming environments, development tools, commercial applications, research projects (possibly non musical), embedded devices, Web applications, etc.","title":"Powered By Faust"},{"location":"community/powered-by-faust/#faust-in-cablesjl","text":"Explore the dynamic integration of the Faust audio library within Cables in this video. This segment delves into the intricacies of generating rich audio experiences on the web, leveraging Faust's advanced capabilities for real-time audio synthesis with synthesizers and oscillators. Discover how to seamlessly compile, modify, and visualize audio within Cables, enhancing your projects with intricate audio-visual synchronization and interactive controls, inviting viewers to contribute and experiment with this powerful tool.","title":"Faust in Cables.jl"},{"location":"community/powered-by-faust/#polyblep-hole","text":"A Faust collection of externals for Pure Data stuck together on the Organelle . The polyBLEPs are the work of Jacek Wieczorek. v1.1 triples the oscillators as sounded a bit thin. The greyhold reverb is immense.","title":"polyBLEP HOLE"},{"location":"community/powered-by-faust/#onetrick-keys","text":"A physically modeled piano synth with a chill lo-fi sound. It uses a vintage algorithm developed at Stanford in 1995 called \"Commuted Piano Synthesis\", and runs that through studio reverb, vinyl or tape noise, flutter, bitcrushing, and saturation. The project is using Rust and the Faust to Rust backend, and the source code is available .","title":"OneTrick KEYS"},{"location":"community/powered-by-faust/#mod-audio","text":"The compact and powerful standalone guitar effects ecosystem to express your creativity at home, in the studio and on stage, which can be programmed with Faust .","title":"MOD Audio"},{"location":"community/powered-by-faust/#nih-faust-jit","text":"A plugin to load Faust dsp files and JIT-compile them with LLVM. A simple GUI is provided to select which script to load and where to look for the Faust libraries that this script may import. The selected DSP script is saved as part of the plugin state and therefore is saved with your DAW project.","title":"nih-faust-jit"},{"location":"community/powered-by-faust/#ambientgarden","text":"ambient.garden is a musical landscape in a website, developed using Teasynth with these Faust codes . All the music in ambient.garden is generated from code. The music is then laid out in a landscape which can be explored, either interactively, or automatically when the autopilot is left on.","title":"ambient.garden"},{"location":"community/powered-by-faust/#teasynth","text":"Teasynth is a tool to make music with code in Javascript, Faust and Sporth . There are two main ways of using it: The web editor runs in the browser and provides an instant composition environment. The command line interface can render music to audio files, serve the editor locally, and bundle music code.","title":"Teasynth"},{"location":"community/powered-by-faust/#lich","text":"Technology OWL platform that allows you to use Pure Data, Max Gen or Faust code into your module!. Lich is a Befaco Rebel collaboration that brings back Owl\u2019s platform with this new hardware iteration. It has stereo in and out, four pot controls summed to cv inputs (like the classic Owl module) And as addition, CV and Gate outputs, patch selection with display and USB MIDI host and device connections.","title":"LICH"},{"location":"community/powered-by-faust/#lamb","text":"A lookahead compressor/limiter that's soft as a lamb, written in Faust and Rust. Lamb was made with these goals in mind: Be as clean as possible Give the user full control over the character with the minimum amount of knobs.","title":"lamb"},{"location":"community/powered-by-faust/#faustsynth","text":"Welcome to FaustSynth, a AU/VST monophonic synthesizer built with the Faust programming language. This is the project deliverable for PAT 481: Independent Study in Fall 2023.","title":"FaustSynth"},{"location":"community/powered-by-faust/#envelopforlive","text":"The nonprofit mission of Envelop is to connect and inspire community through immersive listening. Our listening spaces envelop the audience in pristine 3D sound, amplifying the power of music and nurturing our ability to listen together. Some Max/MSP externals are written in Faust .","title":"EnvelopForLive"},{"location":"community/powered-by-faust/#rcverb-reaclassical-verb","text":"A reverb suitable for classical music based on zita-rev1. Available as LV2 and CLAP by default (with optional VST3, VST2 and LADSPA). This plugin is part of the ReaClassical project along with RCComp (\"ReaClassical Compressor\") and Enover (RCVerb's big sister) additionals plugins, also written in Faust.","title":"RCVerb (\"ReaClassical Verb\")"},{"location":"community/powered-by-faust/#wam-studio","text":"Wam-Studio\u2019s is an online tool for creating audio projects that you can imagine as multi-track music. Each track corresponds to a different \"layer\" of audio content that can be recorded, edited, or just integrated (using audio files for example). Some track can be used to control virtual instruments: in that case we record the sound that is generated internally by these virtual instruments (and played using a MIDI piano keyboard, for example). Tracks can be added or removed, played isolated or with other tracks. They can also be \"armed\" for recording, and when the recording starts, all other tracks will play along, while the armed track will record new content. Wam-Studio can host WAM plugins and in particular Faust ones , which can be built following this tutorial .","title":"Wam-Studio"},{"location":"community/powered-by-faust/#snes-echo-simulator","text":"SNES Echo is an cross-platform audio processing plugin, written in Faust. It simulates the SNES SPC700 DSP reverb/echo effect. This plugin does not strive for bit-accuracy and overflow handling, but instead being audibly indistinguishable for \"normal\" SPCs.","title":"SNES Echo Simulator"},{"location":"community/powered-by-faust/#syfala-project","text":"Automatic compilation of Faust audio DSP programs for AMD-Xilinx FPGAs, developed by the Emeraude team , and funded by the FAST ANR project. Supported board models are: Digilent Zybo Z7-10 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Zybo Z7-20 - Zynq-7000 ARM/FPGA SoC Development Board Digilent Genesys ZU-3EG - Zynq UltraScale+ MPSoC Development Board","title":"Syfala project"},{"location":"community/powered-by-faust/#interactive-granular-texture-synthesiser","text":"An interactive granular texture synthesiser built in TouchDesigner, utilising real time signal processing of the domain-specific language Faust (functional audiostream), and the corresponding TD_Faust operator.","title":"Interactive Granular Texture Synthesiser"},{"location":"community/powered-by-faust/#reflex-in","text":"Reflex-in is a sound installation that uses brain-wave streams to create music composition within the Web environment in real time. The work incorporates various state-of-the-art Web technologies, including Web Audio, WebSocket, WebAssembly, and WebGL. The music generated from the algorithm - mapping brain wave signal to musical events - aims to produce a form of furniture music that is relaxing and meditative, possibly therapeutic. The synthesizer part is created from Faust DSP and the installation can be tested here .","title":"Reflex-in"},{"location":"community/powered-by-faust/#faustcgp","text":"Generate new audio synthesizers and filters in FAUST with Recurrent Cartesian Genetic Programming. Given a target sound or impulse response as input, the RCGP will return a FAUST synthesizer or filter, respectively, that best approximates the given signal or impulse response. Samples for an early version of the software can be found here .","title":"FaustCGP"},{"location":"community/powered-by-faust/#onetrick-urchin","text":"A hybrid drum synth that models the gritty lo-fi sound of beats from vintage records without sampling. It takes spectral and physically modeled drums, running them through simulated studio reverb, a vinyl or tape player, and finally a digital sampler. The result is a fat and saturated drum machine that creates a vibe of sampling with the control of a synthesizer. The project is using Rust and the Faust to Rust backend, and the source code is available .","title":"OneTrick URCHIN"},{"location":"community/powered-by-faust/#kbverb","text":"A Faust reverb, based on the Midiverb architecture by Keith Barr .","title":"KBVerb"},{"location":"community/powered-by-faust/#pasfa-paste-faust-code","text":"A paste service for Faust code, to be tested here .","title":"pasfa - Paste Faust code!"},{"location":"community/powered-by-faust/#faustmapper","text":"FAUSTmapper is a tool for binding popular Digital Musical Intrument (DMI) mapping tools to the FAUST ecosystem. The default action for the FAUSTmapper project is establishing a binding to the libmapper project. When the script is run, the entire parameter space of an active FAUST project (with HTTP control enabled) will be discovered. Once discovered, a libmapper signal will be created for each of the parameters identified, including appropriate meta data such as min, max & default values. The following poster was presented at the 4th Annual International Symposium on the Internet of Sounds and was awarded the Best Poster Award.","title":"FAUSTmapper"},{"location":"community/powered-by-faust/#phausto","text":"Pharo is a pure object-oriented programming language and a powerful environment, focused on simplicity and immediate feedback (think IDE and OS rolled into one). Phausto allows to use Faust inside Pharo.","title":"phausto"},{"location":"community/powered-by-faust/#cantor-digitalis","text":"The Cantor Digitalis is a singing voice synthesiser controlled in real time by chironomy, i.e. by manual gesture, using interfaces such as a stylus or the fingers on a graphics tablet. More generally, it can be controlled using any MIDI interface. The synthesiser has been reimplemented in Faust by Gr\u00e9goire Locqueville during his PhD thesis .","title":"Cantor Digitalis"},{"location":"community/powered-by-faust/#karya","text":"Karya is a score language editor with support for scales, instrumental techniques, and ornaments, with special support for Balinese, Javanese, and Carnatic music. It has backends for MIDI, supercollider OSC, lilypond, and an incremental audio renderer that uses Faust or samples. You can write instruments in Faust and integrate them into a score along with samples and MIDI instruments. Due to incremental rendering, even computationally expensive instruments are not a problem.","title":"Karya"},{"location":"community/powered-by-faust/#body-brain-digital-musical-instrument-bbdmi","text":"BBDMI project aims at making music from electrical signals of the muscle and the brain using EMG and EEG technologies. Producing instrumental prototypes in an open way (open software and open hardware) and to document them in the framework of open science (FAIR). The modular system is built with Max/MSP and interfaced with Faust for the purpose of analyzing, processing and mapping electrophysiological signals to sound. The paper An Interactive Modular System for Electrophysiological DMIs received a best paper award at Audio mostly 2023 .","title":"Body Brain Digital Musical Instrument (BBDMI)"},{"location":"community/powered-by-faust/#the-spatbox","text":"The Spatbox is an interface to intuitively generate 3D trajectories and to spatialize them in real-time on a loudspeaker array with Ambisonics, developed by Pierre Lecomte . Each trajectory is described by a parametric curve, where each of the coordinates varies according to a configurable LFO. Depending on the LFO parameters, many trajectories can be generated. The implementation is done in Faust and the project has been presented at PAW 2022 .","title":"The Spatbox"},{"location":"community/powered-by-faust/#muss3640-vocal-synthesiser","text":"The MUSS3640 Vocal Synthesiser is a standalone application/VST3 plugin developed to allow exploratory synthesis of the singing voice. It implements a combination of formant-wave-function and bandpass synthesis techniques. The DSP is written in Faust.","title":"MUSS3640 Vocal Synthesiser"},{"location":"community/powered-by-faust/#riti-room-is-the-instrument","text":"RITI: Room Is The Instrument by Luca Spanedda , is a piece based on a complex system capable of manifesting emergent and chaotic behaviors, where the acoustic personality of an environment (digital or physical) becomes a case of study for the performance and is reflected in terms of variation in the behavior of the system itself. The DSP code is written in Faust. See a video of a \"studio\" performance of the system .","title":"RITI: Room Is The Instrument"},{"location":"community/powered-by-faust/#equis","text":"EQUIS is a 4 Channel DJ Mixer built on top of JACK. It's EQ is inspired by the Playdifferently Model1 and offers per channel a highpass, lowpass and sculpt eq. The code is developed in Rust and the DSP is written in Faust . See the video presentation at Sonoj convention .","title":"EQUIS"},{"location":"community/powered-by-faust/#esp32-wrover-eie-audio-dev-board","text":"A board to play with FAUST sound synthesis language.","title":"ESP32 Wrover E/IE audio dev board"},{"location":"community/powered-by-faust/#kuroscillators","text":"Max/MSP objects for audio and rhythmic synthesis using coupled oscillator networks. Coupled Oscillators networks are dynamical systems that describe how ensembles of interacting elements are able to self-organize and synchronize over time. In terms of sensory perception, they have been examined in a wide range of fields including those related to rhythmic entrainment, biomusicology, psychoacoustics, signal processing, and generative music. The DSP is written in Faust .","title":"Kuroscillators"},{"location":"community/powered-by-faust/#joue-music-instruments","text":"A new way to make music: the Jou\u00e9 Play is a system that combines an expressive multi-instrument, an intuitive app & interactive content, with a range of musical instruments that use touch-sensitive technology to create a unique playing experience. These instruments are designed to be highly expressive, allowing musicians to play with greater nuance and emotion. Part of the audio effects are coded in Faust.","title":"Jou\u00e9 Music Instruments"},{"location":"community/powered-by-faust/#externalchugins","text":"Chugins , short for \"ChucK plugins,\" are plugins for the ChucK programming language . ChucK is an audio programming language that allows for real-time synthesis, composition, and performance of music. Chugins extend the functionality of ChucK by providing additional classes, objects, and modules that can be used to create more complex and intricate music and sound designs. ExternalChugins are a set of chugins exported from Faust.","title":"ExternalChugins"},{"location":"community/powered-by-faust/#mesh2audio","text":"Generate axisymmetric 3D models, or import existing 3D models, and transform them into real-time playable physical audio models! Supports fast DSP generation of physical audio models that sound decently realistic, as well as blazing fast 2D axisymmetric model generation, at the expense of some fidelity. It is an improvement of the mesh2faust tool. The generated audio model can be played in real-time by \"striking\" (clicking) on mesh vertices in the 3D mesh viewer.","title":"mesh2audio"},{"location":"community/powered-by-faust/#onetrick-cryptid","text":"Whispers of a dreaded drum machine with the cold clanging heart of a DX7 in the fearsome frame of a TR-808 echo in dusty backrooms of backstreet recording studios. A contraption conjured under cover of darkness in the heinous pursuit of chart topping tracks, known only as the DX-808. It's time to bring the beast out of the shadows! Allow us to present the world's most accurate recreation of an FM drum synth skeptics say never actually existed. Using a DX7 emulator of our own design, we forged each facet of the CRYPTID, reconstructing its wretched inner-workings. From the \"Log Drum\" Toms to the \"Wood Block\" Cowbell. Blow that Samba Whistle and hit the Gong! Do you want to believe? The project is using Rust and the Faust to Rust backend, and the source code is available .","title":"OneTrick CRYPTID"},{"location":"community/powered-by-faust/#bespoke-anywhere","text":"This paper reports on the Audio Anywhere project, a framework for working with audio plugins that are compiled once and run anywhere. At the heart of Audio Anywhere is an audio engine whose Digital Signal Processing components are written in Faust and deployed with WebAssembly, by Benedict Gaster and Ryan Challinor, presented at Nime 2021 .","title":"Bespoke Anywhere"},{"location":"community/powered-by-faust/#a-technical-framework-for-musical-biofeedback-in-stroke-rehabilitation","text":"We here present work a generalized low-level technical framework aimed to provide musical biofeedback in post-stroke balance and gait rehabilitation, built by an iterative user-centered process. The framework comprises wireless wearable inertial sensors and a software interface developed using inexpensive and open-source tools. The interface enables layered and adjustable music synthesis, real-time control over biofeedback parameters in several training modes, and extensive supplementary functionality. JUCE and FAUST are used to create a versatile architecture for layered, yet computationally efficient real-time music synthesis.","title":"A Technical Framework for Musical Biofeedback in Stroke Rehabilitation"},{"location":"community/powered-by-faust/#forcehost","text":"ForceHost: an open-source toolchain for generating firmware embedding the authoring and rendering of audio and force-feedback haptics, by Christian Frisson, Mathias Kirkegaard, Thomas Pietrzak, and Marcelo M. Wanderley presented at Nime 2022 . The Faust compiler has been modified to support haptics.","title":"ForceHost"},{"location":"community/powered-by-faust/#sentinelle","text":"Sentinelle is a sound and robotic art installation made by J\u00e9r\u00f4me Abel . A robot-probe is placed in a dark place, a cellar. It scans its surroundings with two lasers. The reliefs of the old walls, their imperfections, mold, appear thanks to the perfectly straight lines of the lasers. Its movements are synchronized with a sound program. From these very simple visual and sound choreographies are born an imaginary on its functioning and the origin of its presence. The spectator observes in a mirror a robot which observes and testifies. Does it communicate with other systems? Does it send information? Its energy is precious, like a heartbeat or a breath, it works in a segmented way with periods of silence. Likewise, his movements are slow and relentless. Faust objects from https://github.com/grame-cncm/faust/tree/master-dev/examples included with pd-faustgen : examples/gameaudio/bubble examples/delayEcho/echo examples/gameaudio/rain examples/generator/sawtoothLab","title":"Sentinelle"},{"location":"community/powered-by-faust/#langfaust-and-uifaust","text":"CEAMMC PureData distribution 2023.02. General purpose Pd distribution and library used for work and education purposes in Centre of electroacoustic music of Moscow Conservatory ( CEAMMC ) and ZIL-electro studio. This repository is an assembly of Puredata that includes the CEAMMC library. It includes the lang.faust~ and ui.faust~ externals and a lot of Faust DSP .","title":"lang.faust~ and ui.faust~"},{"location":"community/powered-by-faust/#arco4-sound-synthesis-engine-and-framework","text":"Arco is a sound synthesis engine that offers dynamic patching of of unit generators. It is designed to operate as a small embedded server, running either in its own process or within an application. In the spirit of \"smaller is better,\" Arco DSP is mainly delegated to FAUST , leveraging a wide range of existing algorithms. Arco control is delegated to external languages connecting through O2, which supports running Arco within the same application, in a separate process or even on a remote networked host. Arco should be a nice alternative to libpd as an embedded sound engine. The author is mainly using Arco in tandem with Serpent, a real-time Python-like scripting language, but other language bindings are possible.","title":"arco4 - sound synthesis engine and framework"},{"location":"community/powered-by-faust/#synthesizer-synthesizer","text":"This is a dual-course project for CS378 NLP and CS393P. The goal is to use language model guided program synthesis to synthesize Faust DSP code to ... automatically program synthesizers. Not guaranteed to work. In the slightest.","title":"Synthesizer-synthesizer"},{"location":"community/powered-by-faust/#ambisonics-in-kmh-studios-and-lilla-salen","text":"The general idea behind using ambisonics for diffusing sounds in a space is to, in the first stage, encode an audio signal to a representation of a sound field - a B-format signal. This B-format signal is independent of whatever speaker array the signal will later be diffused on. In the second stage the B-format signal is decoded to the layout of a particular speaker array. In between these two stages a number of transformations may be applied, but the sound source specification may conveniently be specified in the encoder. The decoders are written in Faust.","title":"Ambisonics in KMH studios and Lilla salen"},{"location":"community/powered-by-faust/#sardine","text":"Sardine is a free/open-source software for Python 3.10+. It turns Python into a musical instrument. You can play it alone or with your friends. With Sardine you can: Play synthesizers and audio samples using SuperCollider. Control synthesizers through MIDI/OSC messages. Interconnect audio/video softwares and/or sound engines. Play collaboratively with your friends. Extend your musical environment using any Python package. Faust written DSP can be used in Sardine.","title":"Sardine"},{"location":"community/powered-by-faust/#kandiskyscore","text":"KandiskyScore is a graphical editor for the analysis and creation of electroacoustic/acousmatic music. It is an html/javascript application. It works perfectly with Firefox, Chrome and Opera and therefore on all Windows, OSX, Linux and other PCs. It uses the WebAudio API for sound generation and the Faust language of the GRAME for plugins. It also allows you to export a graphic score in SVG format that you can eventually modify with a vector graphics software like Inkscape or LibreOffice-draw.","title":"KandiskyScore"},{"location":"community/powered-by-faust/#fildesoi1_2_3","text":"Software (including Faust code , Max and PureData patches) to perform Fil de Soi 1 and Fil de Soi 2, mixed music pieces by Alain Bonardi for acoustic guitar and electronics.","title":"fildesoi1_2_3"},{"location":"community/powered-by-faust/#enecho","text":"Faust code for En Echo piece by Manoury for soprano and live electronics.","title":"enecho"},{"location":"community/powered-by-faust/#zen-flute","text":"The Guthman Musical Instrument Competition is one of the only competitions of its kind - an event dedicated to identifying the newest and greatest ideas in music. Every year, we invite musical inventors from around the world to share their creations and ideas about the future of music. This year first price is Keith Bexter with the Zen Flute , which sound is produced by a physical model of flute written in Faust , and running on a Teensy audio board .","title":"Zen Flute"},{"location":"community/powered-by-faust/#souffle","text":"An electro track made with Faust . You can listen to a recording here .","title":"souffle"},{"location":"community/powered-by-faust/#ghg-gruppenhorchgerat","text":"The project is a demonstration of a technique called delay-sum beamforming with the aim to replicate the sound heard by operators of passive sonar devices used in the second world war. Listen to the video here . The simulation code is written in Faust.","title":"GHG (Gruppenhorchger\u00e4t)"},{"location":"community/powered-by-faust/#satuverb","text":"Satuverb is a flexible reverb that has many creative and natural sounding uses, produced by request for FBPM. It has a saturator and EQ controls inside the reverberator, which apply every time the signal is fed back. This causes the effects to grow more extreme as the reverb tail trails off. Satuverb's reverberator is based on Jon Dattorro's 1997 design and written in Faust .","title":"Satuverb"},{"location":"community/powered-by-faust/#faustilogue","text":"Convert Faust DSP files to KORG logue custom oscillators, using the logue SDK .","title":"faustilogue"},{"location":"community/powered-by-faust/#blippoo-for-wingie","text":"Blippoo for Wingie is an alternative firmware for Wingie2. The new firmware is inspired by Blippoo Box, a genius instrument created by Rob Hordijk (1958-2022), who contributed a lot to synthesizer design. May his spirit lives on in his instrument designs, thoughts, and influences. The new firmware could turn your Wingie2 into a self-contained instrument capable of producing a variety of sounds and patterns. As a great companion, it will help you in your music-making practice especially when you want to applicate controlled chaos in your music. The DSP is written in Faust .","title":"Blippoo for Wingie"},{"location":"community/powered-by-faust/#6171_reverb","text":"A vintage reverb based on designs from 1961 and 1971, written in Faust .","title":"6171_reverb"},{"location":"community/powered-by-faust/#teensy-wfs","text":"Distributed Wave Field Synthesis (WFS) implementation for networked Teensies. There is a WFS Controller JUCE app in wfs-controller. This uses JACK's C API to set up ports and connect to any Teensy JackTrip clients. It notifies the clients of their positions in the WFS array, plus the positions of virtual sound sources, via OSC over UDP multicast. The WFS algorithm is written in Faust .","title":"teensy-wfs"},{"location":"community/powered-by-faust/#pd-remote","text":"This is a simplified and unified version of the Pd remote control helpers that I've been distributing with various Pd externals such as pd-faust and pd-lua over the years. The present implementation will work with any of these and replaces the more specialized versions. It takes the form of a Pd abstraction pd-remote.pd and an accompanying pd-remote.el elisp file for Emacs.","title":"pd-remote"},{"location":"community/powered-by-faust/#crossroad2effects","text":"Crossroad2Effects, the functional successor to @jatinchowdhury's CrossroadsEffects , is a genetic algorithm infrastructure for filter exploration. Provided with dry and wet sound file, Crossroad2Effect determines the filter that tampered the dry file and presents it as a Faust program. This allows users to have granular access to analog or VST filters through a programming interface. This project constructs its genetic algorithm search on top of pedalboard, Spotify's new plugin API.","title":"Crossroad2Effects"},{"location":"community/powered-by-faust/#flatten","text":"What is an envelope flattener ? It's similar to an automatic gain control, compressor, or maximizer in that it acts by modifying the gain of the signal according to a control signal. Like these, the control signal is derived from the envelope of the input signal. The DSP is written in Faust .","title":"flatten"},{"location":"community/powered-by-faust/#drumvoice","text":"Drumvoice is a percussion instrument LV2 plugin. Drumvoice can also make lots of other percussion sounds, like kick drums, toms, single hand claps, and all kinds of smaps and blinks. The DSP is written in Faust .","title":"drumvoice"},{"location":"community/powered-by-faust/#verber","text":"Verber is a simple audio plugin tool with a Sweet, Lushy reverb processor. It is a portolio project built in JUCE and HISE, with the DSP in Faust .","title":"Verber"},{"location":"community/powered-by-faust/#reach","text":"Extraterrestrial Reverb for Electronic Music. REACH is modern creative Reverb that is made for synthetic sound sources. There are four effects included to transform the Signal. It features modular routing, pre and post filters and over 40 Presets. Part of the DSP code is written in Faust .","title":"REACH"},{"location":"community/powered-by-faust/#stray_virtual-synth","text":"A typical wavetable synthesizer will have a table of predetermined amplitude values which are read through at the appropriate speed relative to the frequency of the current note, resulting in an audible signal. Stray functions similarly, reading through a table of values, but the amplitude values are not predefined. Instead, these values are modulated with one of four LFO shapes. The DSP code is written in Faust.","title":"Stray_virtual-synth"},{"location":"community/powered-by-faust/#drty-drums","text":"A 4 voices drum machine based on FM synthesis [WIP]. The sound engine is made in Faust .","title":"Drty Drums"},{"location":"community/powered-by-faust/#201-musical-synthesizer","text":"We\u2019re Critter & Guitari and we\u2019re happy to announce our newest synthesizer: the 201! If you\u2019re familiar with our other musical instruments such as the Pocket Piano, Organelle, Bolsa Bass, or Kaleidoloop, we hope you\u2019ll see that the 201 fits right in with them: the 201 is fun, portable, and packed with a medley of musical magic! Inside, the 201 uses a combination of Pure Data and Faust musical programming environments. Users are invited to modify or create new sound engines!","title":"201 Musical Synthesizer"},{"location":"community/powered-by-faust/#onetrick-simian","text":"Crash into the 80s with an open source drum synth inspired by hexagonal classics like the Simmons SDS-V . Thumping kicks , punchy snares , and sizzling cymbals coalesce with its clacky claves and crunchy claps . Bring saccharine synthwave sauce to your sublime soundscapes or drop indelable pewww pewww tom toms into your new nu-disco . Get the source code containing Faust DSP , using the Dlang backend.","title":"OneTrick SIMIAN"},{"location":"community/powered-by-faust/#collisiondrivelv2","text":"CollisionDrive is modeled after the Horizon Devices Precision Drive, a modern overdrive pedal with a built-in noise gate, with DSP written in Faust .","title":"CollisionDrive.lv2"},{"location":"community/powered-by-faust/#metaltonelv2","text":"Distortion Pedal simulation. MetalTone is modeled after the renowned BOSS MT-2 Metal Zone, a high gain distortion pedal with an advanced EQ section, with DSP written in Faust .","title":"MetalTone.lv2"},{"location":"community/powered-by-faust/#tamgamplv2","text":"Tamgamp (Rhymes with: \"Damage Amp\") is a LV2 guitar amp simulator that provides two plugins, with DSP code developed with Faust : Tamgamp - a plugin based on Guitarix DK Builder simulated chains. TamgampGX - a plugin based on tuned Guitarix internal amplifiers implementation.","title":"tamgamp.lv2"},{"location":"community/powered-by-faust/#reverbzen","text":"A Reverb written with Faust and JUCE, based on SchroederReverberators . This reverb effect uses different stages. It splits input signal in parallel and uses different types of delaylines. Different filters are provided to get rid of unwanted resonances. Check out reverb.dsp file to get more detailed insight.","title":"ReverbZen"},{"location":"community/powered-by-faust/#wingie2","text":"Wingie2 is a handheld stereo resonator that you can use as a development platform, and can be programmed with Faust .","title":"Wingie2"},{"location":"community/powered-by-faust/#slowmolv2","text":"A multiband slow gate with delay/echo. The C++ files for the effect are generated from Faust DSP files: Bandsplit.cc , Delay.cc and Volume.cc .","title":"Slowmo.lv2"},{"location":"community/powered-by-faust/#vocoder-app","text":"Vocoder mobile app for Android made with Faust and its Smartkeyboard interface. This app was developed in the context of a project for the the Real Time Interaction and Performance exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2020). The paper A Faust-built Mobile Vocoder Instrument, included in the repo, provides more information on the algorithm, as well as the description of a case prototype.","title":"Vocoder App"},{"location":"community/powered-by-faust/#echoplex-ep-3-simulator","text":"This archive contains a virtual model of the Echoplex Ep-3 tape delay. The effect has been developed using Faust in the context of a project for the Sound Processing exam (Sound and Music Computing MSc, Aalborg University, Copenhagen, 2019). The paper Faust Model of the Echoplex Tape Delay, included in the repo, provides more information on the algorithm.","title":"Echoplex Ep-3 Simulator"},{"location":"community/powered-by-faust/#faust2smartphone","text":"faust2smartphone is a tool to generate interactive musical mobile application embedded Faust API.","title":"faust2smartphone"},{"location":"community/powered-by-faust/#dpf-fadeli","text":"An experiment with Faust Demo Library content as DPF plugins. Basically glueing a few different projects together, to compile Faust DSP programs in several plugins format: LADSPA, LV2, VST2, VST3, CLAP : DPF faust faustpp faust examples","title":"DPF-Fadeli"},{"location":"community/powered-by-faust/#tr8ck","text":"TR8CK is an experimental DAW/tracker with Faust live coding via faust2webaudio and UI powered by SolidJS .","title":"TR8CK"},{"location":"community/powered-by-faust/#guitard","text":"It's a basic multi effects processor which follows a node based approach. Components are developed with Faust .","title":"GuitarD"},{"location":"community/powered-by-faust/#hise","text":"HISE is an open source framework for building sample based virtual instruments combining a highly performant Disk-Streaming Engine, a flexible DSP-Audio Module system and a handy Interface Designer. The implementation of the Faust integration was the result of a Google Summer of Code project done by Roman Sommer with the help of Christoph Hart as mentor.","title":"HISE"},{"location":"community/powered-by-faust/#mbstereophony","text":"This is a simple implementation of a Regalia-Mitra filter bank using 3rd order Cauer low-pass filters as the base designs. There are four filter bank programs available which are described below. MBStereophony itself is a demo effect that down-mixes a stereo signal separately per frequency band.","title":"MBStereophony"},{"location":"community/powered-by-faust/#audiolab","text":"A docker based DSP learning/Experimentation environment including: Jupyter lab FAUST python 3.7 (at the moment. Depends on miniconda3 docker image) FAUSTpy to run FAUST code inside jupyter faustWidgets (to interactively control FAUST code ) librosa (for MIR and feature extraction) scipy, pandas, numpy for general data science sox (encoding, batch processing etc) ffmpeg (encoding batch processing etc) seaborn (more beautiful plots) latex TODO (for exporting jupyter notebooks)","title":"Audiolab"},{"location":"community/powered-by-faust/#lr_delay","text":"A stereo delay plugin which emphasizes free (non beat-synced) controls for the individual channels. Built with Faust and JUCE.","title":"LR_Delay"},{"location":"community/powered-by-faust/#leslie-speaker-simulator","text":"This archive presents a virtual simulation of the Leslie Speaker commonly found in Hammond electric organs. The digital effect has been developed using the FAUST programming language, and then ported into a VST-compatible format using the JUCE C++ framework.","title":"Leslie speaker simulator"},{"location":"community/powered-by-faust/#cookiecutter-dpf-faust","text":"A cookiecutter project template for DISTRHO Plugin Framework ( DPF ) audio effect plugins using FAUST for the implementation of the DSP pipeline. Look at the demo video .","title":"cookiecutter-dpf-faust"},{"location":"community/powered-by-faust/#df-zita-rev1","text":"A feedback-delay-network reverb plugin built with DPF and based on a FAUST library demo. Several other projects are developed using the same DPF/FAUST methothodolgy: FAUST filters , a collection of virtual-analog filters from the FAUST standard library packaged as multi-format plugins via the DPF SendMixer , a stereo channel strip plugin with one master gain and two pre/post-fader sends Stereo Cross Delay , a stereo delay plugin with feedback and cross-mixing.","title":"DF Zita Rev1"},{"location":"community/powered-by-faust/#theremotion","text":"Theremotion is a virtual instrument inspired by the Theremin. Just like a Theremin, the position of your hand in the air controls the pitch and volume of the sound. However, you can also control much more dimensions of the sound with specific motions. With specific hand positions, you can control a low pass filter, a supersaw sound, a guitar sound and more. You can even make the instrument \"stick\" to a scale, making it much easier to control than a Theremin. The hand tracking is provided by Ultraleap's Leap Motion Controller . The sound generation is created with Grame's Faust . The program is built with Rust .","title":"Theremotion"},{"location":"community/powered-by-faust/#hypercurve","text":"Hypercurve is a library allowing you to combine several curve algorithms into a single 2D envelope. It is designed to be used in audio applications, for people who know how to enjoy a finely shaped curve. As shown above, you can perfectly combine gaussian curve with diocles cissoid curve, and plenty of other curve algorithms. The library can be used in C++, Lua, Csound and Faust .","title":"Hypercurve"},{"location":"community/powered-by-faust/#faust-mcp","text":"This package provides a Pd abstraction mcp.pd (along with some helper abstractions and externals) which lets you control your Faust instruments and effects more conveniently with control surfaces utilizing the Mackie Control Protocol (MCP).","title":"faust-mcp"},{"location":"community/powered-by-faust/#faustquark","text":"This SuperCollider package makes it possible to create SuperCollider packages (Quarks) containing plugins written in Faust code. With this, you can distribute plugins written in Faust and make it easy for others to install, compile or uninstall them. It also contains some simple interfaces for the faust and faust2sc.py commands used behind the scenes.","title":"Faust.quark"},{"location":"community/powered-by-faust/#komet","text":"Komet is a computer music / sound system by Mads Kjeldgaard written in SuperCollider and Faust . Komet is a computer music system that makes advanced synthesis operations and composition easier. It auto generates thousands of synthesizer variations from simple recipes and offers a range of DAW-like features such as effect chains (like on channel strips) and other conveniences. It can work natively in stereo, multichannel or high order ambisonics mode with the flick of a switch, allowing the same compositions to be used in different sound systems.","title":"Komet"},{"location":"community/powered-by-faust/#faug","text":"A Minimoog Model D emulation with the DSP portion written in Faust and using JUCE framework. Moog + Faust = Faug.","title":"Faug"},{"location":"community/powered-by-faust/#striso-studio","text":"A virtual Web version of the Striso board, using the Faust WebAssembly compiled sythesizer code .","title":"Striso Studio"},{"location":"community/powered-by-faust/#sttera","text":"A Software for Audio Recognition and Orchestration as Medium for Music Ritual. Faust WebAssembly library is used internally with the faust2webaudio project.","title":"Sttera"},{"location":"community/powered-by-faust/#xuidesigner","text":"A WYSIWYG LV2 X11UI GUI creator tool. Provide a easy to use GUI generator tool to create X11 UI's for LV2 plugins. Currently only libxputty is supported, but the generated GUI C file could be used probably with other widget tool-kits as well, just a wrapper file is needed to translate the generated file to the needs of a toolkit. XUiDesigner could now parse faust (.dsp) files and generate a full LV2 Bundle for them. A faust (.dsp) file could be given by the command-line parameter -f or simply by drag it on the Designer window. It will create all control widgets which you could then rework to your needs before you save your Bundle.","title":"XUiDesigner"},{"location":"community/powered-by-faust/#dsp-speech-processor","text":"A Faust based DSP Speech Processor. Based on the Daz DSP v2.1 Speech Processor firmware, with improvements. Compiled into Webassembly format. Runs in a web browser!","title":"DSP Speech Processor"},{"location":"community/powered-by-faust/#squaring-loop-synchronous-am-isb-demodulator","text":"This demodulator uses a squaring loop to regenerate the AM carrier from the sidebands during signal fades. This allows it to maintain carrier lock even without a carrier! The squaring loop multiplies the signal with itself, causing a 2F carrier to be generated. Carrier + carrier = 2F. LSB + USB = 2F.","title":"Squaring Loop Synchronous AM ISB Demodulator"},{"location":"community/powered-by-faust/#eurorack-blocks","text":"The eurorack-blocks project allows to develop your own custom Eurorack module for either prototyping or fun in the comfort of your day-to-day IDE with the C++ or Faust language , or using the Cycling '74 Max environment, testing and debugging in a virtual Eurorack environment, and when ready, to auto-magically generate all the needed files to manufacture the eurorack module for you to use in a real Eurorack modular system.","title":"eurorack-blocks"},{"location":"community/powered-by-faust/#amstramgrame","text":"An arts and sciences educational project (STEAM), bringing together services and resources for the educational community. It aims at making abstract scientific concepts more tangible and concrete through musical creation and computer programming. The Gramophone is an audio device/musical instrument specifically designed for the AmStramGrame project. Its various sensors and controllers (e.g., accelerometer, gyroscope, light sensor, etc.) make it react to the user's gestures. Its rechargeable battery offering approximately five hours of autonomy and its powerful speaker make it independent from any computer, bringing it closer to traditional acoustic musical instruments. DSP programs are coded in Faust . Additional examples can be found in GramoCollection .","title":"AmStramGrame"},{"location":"community/powered-by-faust/#gamelan","text":"GameLAN is a set of musical applications designed by Grame , National Center of Musical Creation. They are based on Faust technology and have been designed to be played using only the movements of the smartphone. No musical prerequisite, only your gestures will make you a musician!","title":"GameLAN"},{"location":"community/powered-by-faust/#screamer","text":"Version 1.0 is the accurate Faust reproduction of a VST plug-in written in 2003. In later versions, the parameter ranges is modified and some new functionality are added. This signal mangler features a weird kind of overdrive (see source code for exact formula), a hard-clip distortion, LFO-modulated bit reduction and the possibility of calculating the modulo of a signal.","title":"Screamer"},{"location":"community/powered-by-faust/#typebeat","text":"Typebeat is a virtual groovebox that\u2019s entirely keyboard-operated. Typebeat draws inspiration from two computing environments. Effects are developped in Faust then generated as Rust modules .","title":"Typebeat"},{"location":"community/powered-by-faust/#afdn-reverb","text":"(High-Order) Ambisonics Feedback Delay Network Reverb. Code is developed in Faust and Max.","title":"AFDN-reverb"},{"location":"community/powered-by-faust/#karpsichord","text":"A virtual harpsichord based on Karplus-Strong string synthesis, implemented in Faust and running in the Web .","title":"Karpsichord"},{"location":"community/powered-by-faust/#arduino-audio-tools","text":"Some basic header-only C++ classes that can be used for Audio Processing provided as Arduino Library. A simple Interface class to use Faust with Arduino Audio Tools is provided . Code can be written using Faust .","title":"Arduino Audio Tools"},{"location":"community/powered-by-faust/#organelle","text":"The Organelle makes it easy to explore new sounds and experiment with new ways of making music. It combines playful and intuitive controls with a powerful and flexible sound engine. The result is an instrument that is limitless in musical possibility and a joy to play. At the heart of the Organelle's sound engine is a robust computer that runs patches. A patch allows the instrument to take on different forms. Onboard hardware for sound input and output and mappable knobs, keys and buttons enable patches to synthesize, sample, effect, and anything in between! The Organelle can be programed with Faust as explained here and with this PD external using Faust .","title":"Organelle"},{"location":"community/powered-by-faust/#zrythm","text":"Zrythm is a digital audio workstation designed to be featureful and easy to use. It offers streamlined editing workflows with flexible tools, limitless automation capabilities, powerful mixing features, chord assistance and support for various plugin and file formats. A set of Faust effects are compiled as LV2 plugins and included in the application.","title":"Zrythm"},{"location":"community/powered-by-faust/#patches-for-the-owl-pedaleurorack-module","text":"This is a collection of patches written or ported specifically for the OWL. Most of them were written using FAUST and if you want to modify them you'll need to have a working FAUST installation. C++ source code (the .hpp files) for the OWL can be generated by running the \"updateFaustPatches.py\" python script. Then you will need to rebuild the OWL firmware and upload it to the device.","title":"Patches for the OWL Pedal/Eurorack Module"},{"location":"community/powered-by-faust/#kiwi","text":"Kiwi is a graphical programming environment dedicated to music and sound creation, such as Max or Pure Data softwares, but offering a real-time collaborative approach: Kiwi allows several distant users to work simultaneously on the same patch hosted online. Kiwi is part of the French ANR-funded MUSICOLL project that unites the CICM and OhmForce. The main goal of this project is to study how collaboration can enhance the way digital audio music composition is taught and more generally how it can renew music creation practices and improve its workflow. Faust DSP programs can be dynamically compiled as objects included in the patch. An extended presentation of the system can be found in this IFC 2020 paper .","title":"Kiwi"},{"location":"community/powered-by-faust/#brainwave-virtual-instrument","text":"The Brainwave Virtual Instrument (BVI) is an open-source software synthesizer built in the programming language Faust. Its purpose is to facilitate the exploration of electroencephalogram (EEG) and other brain data through sonification. Pre-recorded data is translated as parameter controls of the instrument in the form of Open Source Control (OSC) messages that are generated and streamed by a small python program. The instrument can easily be distributed and compiled to different targets thanks to Faust\u2019s flexibility. Frequency Modulation synthesis provides a comprehensive approach to textural parameters of sounds, so that musical composition and improvisation based on a creative use of brain data become feasible. This is exemplified by the Brainwave Etudes (BE), a series of compositions inspired by measurements of brain activity during different states of mind. The BVI was created for two major purposes: on the one hand, to find musical structures that relate to each other in order to present an aesthetic proposal, and on the other, to create a tool that familiarizes scientists and researchers in the field of neuroscience with sonification techniques, and the exploration of brain activity through sound. An extended presentation of the system can be found in this IFC 2020 paper .","title":"Brainwave Virtual Instrument"},{"location":"community/powered-by-faust/#mephisto","text":"Mephisto is a transpiler for converting sound patches designed using the graphical computer music environment Pure Data to the functional DSP programming language Faust. Faust itself compiles into highly-optimized C++ code. The aim of the transpiler is to enable creating highly optimized C++ code embeddable in games or other interactive media for sound designers, musicians and sound engineers.","title":"Mephisto"},{"location":"community/powered-by-faust/#weather_organ","text":"Weather Organ is a Faust instrument for manipulating sparse noise to imitate slowly-changing natural sound sources such as rain, wind, surf, fire, Geiger counters and volcanic activity, and to create interesting new textures of sound. It is the product of various discoveries made while using Faust to explore the definition, synthesis and experience of acoustic noise while, simultaneously using the exploration of noise as as focus for learning Faust.","title":"weather_organ"},{"location":"community/powered-by-faust/#genius-eurorack-module","text":"The Genius is the next evolutionary step for the OWL platform, and the first product released based on a Cortex M7 microcontroller. It runs the OWL firmware and so can be programmed with Faust. A demo running bells from thee physical library can be listened to here .","title":"Genius Eurorack Module"},{"location":"community/powered-by-faust/#dataflow-based-fpga-program-synthesis","text":"A Yale-NUS BSc. (Hons) in Mathematical, Computational, and Statistical Sciences Capstone: an FPGA Program Generator written in Python that takes dsp-sig XML Dataflow Graphs created using FAUST to produce FPGA programs in VHDL.","title":"Dataflow Based FPGA Program Synthesis"},{"location":"community/powered-by-faust/#dspedal","text":"DSPedal is a custom hardware platform for real-time sound effects. It is operated by few knobs, external expression pedal, couple of buttons and a small graphical LCD. Processing effect is written in Faust programming language and compiled into C code. So far the Cortex M4 core clocked at 204 MHz has proven to be capable of executing relatively complex effects like wah, but effect-chaining quickly reaches the limits of processing power.","title":"DSPedal"},{"location":"community/powered-by-faust/#tambura","text":"Waveguide physical model of an Indian Tambura/Tanpura. This is a FAUST patch inspired by the Indian Tambura/Tanpura - a four string drone instrument, known for its unique rich harmonic timbre. The model uses a few tricks to produce a Tambura-like sound, and should probably be referred to as a \"pseudo\" physical model, because it does not attempt to accurately recreate the physics of the string-bridge interaction. It includes a range of parameters selected to allow control of the qualities of the excitation/pluck, string behavior and sympathetic resonance. It can produce some beautiful evolving drones, which can vary from very synthetic to quite natural. The model can be tested here .","title":"Tambura"},{"location":"community/powered-by-faust/#drumbox","text":"drumbox is a fun and powerful drum synthesizer for your Android device. Start from a preset and tweak the sounds and appearance to make it your own. Freestyle on the drum pads, record a sequence or both...it's up to you!","title":"drumbox"},{"location":"community/powered-by-faust/#granola","text":"Granola is a monophonic granular live feed processor. The grain processor is inspired by the Mutable Instruments Beads. The grain window shape control is inspired by the GR-1 Granular synthesizer from Tasty Chips Electronics. The DSP code is written in Faust.","title":"Granola"},{"location":"community/powered-by-faust/#fverb","text":"A stereo variant of the reverberator by Jon Dattorro coded in Faust.","title":"fverb"},{"location":"community/powered-by-faust/#sonification","text":"This study has been developed as a proof-of-concept for data pattern sonification. We've implemented data pattern sonification using FM synthesis coded in Faust. Air pollution data, which is temporal, is retrieved from the server and is done pattern mining. Then pattern data sonification is done.","title":"Sonification"},{"location":"community/powered-by-faust/#gula-plugins","text":"A collection of guitar effect LV2 plugins ( The Vibey , The Splits , The Fades , SSaP Tone , Sweabed , Pequed , Peak audio to CV , LFO CV ) with MOD Devices user interfaces.","title":"GULA Plugins"},{"location":"community/powered-by-faust/#limiterstereo","text":"Yet another look-ahead limiter code in Faust. The novel aspect of this limiter is that it uses N cascaded one-pole filters for amplitude profiling, which improves smoothness in the first to N-1 order derivatives and reduces total harmonic distortion. This design uses four cascaded one-pole lowpass filters, following the cut-off correction formula (8.9) found in [Zavalishin 2012].","title":"limiterStereo"},{"location":"community/powered-by-faust/#web-audio-modules","text":"Web Audio Modules are an open source framework facilitating the development of high-performance Web Audio plugins (instruments, realtime audio effects and MIDI processors). They can be developed using JavaScript and Web standards or compiled from C, C++ code, and domain-specific languages such as Faust or Csound. The Faust Web IDE contains an integrated GUI builder, read a tutorial here .","title":"Web Audio Modules"},{"location":"community/powered-by-faust/#kapitonov-plugins-pack","text":"Set of 7 plugins for guitar sound processing, compiled in LADSPA and LV2 formats. Compatible with hosts such as Ardour, Qtractor, Carla, guitarix, jack-rack. The DSP of all of them is written in Faust.","title":"Kapitonov Plugins Pack"},{"location":"community/powered-by-faust/#tubeamp-designer","text":"Standalone software guitar processor, editor of *.tapf profile files for tubeAmp (KPP) and guitar amp profiler.","title":"tubeAmp Designer"},{"location":"community/powered-by-faust/#biosignals","text":"BioSignals is a data aquisition and processing device for EMG, ECG and EEG signals. Since it is using the OpenWare firmware, it can be programmed with Faust.","title":"BioSignals"},{"location":"community/powered-by-faust/#scale-it","text":"Scale it is an open source program (written in graphical programming language Pure data and in Faust) that allows sonification of a signal distribution in real time. There are two different possibilities of sonification of the signal. One of the objects, tone, generates changes in pitch of a monophonic tone. The other object, chord, expresses the input value in width of polyphony. Scale it is being developed primarily for neurofeedback purposes. To allow straightforward and customizable instruments to carry sonic feedback about EEG activity in specific regions of the neocortex.","title":"Scale it"},{"location":"community/powered-by-faust/#jacktrip","text":"JackTrip is a Linux, macOS, or Windows multi-machine audio system used for network music performance over the Internet. It supports any number of channels (as many as the computer/network can handle) of bidirectional, high quality, uncompressed audio signal streaming. Several DSP effects ( compressor , freeverb , zitarev , limiter ) are written in Faust, compiled as C++ code, and included in project sources .","title":"JackTrip"},{"location":"community/powered-by-faust/#level-rider","text":"This is an audio plugin written in Faust that automates gain level adjustments, based on a target gain level, a time window over which overall loudness is calculated via RMS, and a maximum adjustment threshold. This plugin is comparable to Waves Vocal Rider or Waves Bass Rider in its functionality, but is free and open-source.","title":"Level Rider"},{"location":"community/powered-by-faust/#whetstone-transient-shaper","text":"A free, open source transient shaping audio plugin that operates on a specified frequency band. Whetstone will extract a certain frequency band based on a low cutoff and high cutoff that you choose, apply transient shaping to it, and then reintegrate the shaped band back into the original signal. This plugin is meant to be comparable to the excellent Spiff plugin in its core functionality, but lacks many of the nice features and polished UI. The DSP is coded in Faust .","title":"Whetstone Transient Shaper"},{"location":"community/powered-by-faust/#reverb-trickery","text":"A free, open source audio plugin implementing various creative reverb effects, including octave-shifted, distorted, hi-pass/low-passed, gated, and narrowing reverb, coded in Faust .","title":"Reverb Trickery"},{"location":"community/powered-by-faust/#b259wf","text":"This is a model of the \"tibre\" circuit of the Buchla 259 Complex Wave Generator, made in Faust . The model follows the circuit modelling as seen on the paper Virtual Analog Buchkla 259 wavefolder , using 5 folds. The proposed 2-point BLAMP antialiasing method has been attempted for arbitrary sources as shown here , but it is not sufficient for high frequencies and/or more complex signals. Instead, filtering and light cubic nonlinearity distiorion has been used to round corners and for clipping. The user interface consists of the controls fold for the folding amount, offset for offseting the signal before folding, and lowpass as a final stage one-pole filtering to control the character (too much folding might introduce unwanted higher harmonics for certain signals). The final output is dc-blocked.","title":"b259wf"},{"location":"community/powered-by-faust/#string-machine","text":"This is a virtual-analog string ensemble synthesizer. The implementation is based on a digital model designed by Peter Whiting. The improvement of the model adds various abilities, in particular a virtual-analog emulation of the bucket brigade delay circuit. Most of the DSP code is developed using Faust. Three VST or LV2 are generated: string-machine , string-machine-chorus and string-machine-chorus-stereo .","title":"string-machine"},{"location":"community/powered-by-faust/#metafx","text":"The metaFx is a control surface for continuous sound transformations in real time, just like the metaSurface64. Like metaSurface64 , it has both its own loop generator and a multi-effects FX engine, but its operation is different, especially for the management of plugin chains and pads. Each mixer on this surface can directly control the gain and the attached plug-ins. It is also possible to control the tracks of an external sequencer (Ardour or Reaper). To do this, the application uses OSC controllable modules that come from the Faust language library that is embedded in the application. Its interest lies in the construction of a parallel sound processing chain in the form of a graph.","title":"metaFx"},{"location":"community/powered-by-faust/#kymaticacom","text":"Jonatan Liljedahl at Kymatica AB makes iOS music apps, electronic music, and a little bit of audio hardware. The following iOS applications have DSP code developed using Faust: AU3FX:Push : AUv3 dynamics processor with noise gate, compressor/expander with external side-chain input, brick-wall look-ahead limiter and hard/soft clipper. AU3FX:Space : High quality tweakable AUv3 reverb with resonant filters. For everything between small rooms, resonators, and infinitely large spaces. AU3FX:Dub : Stereo AUv3 delay effect for everything from clean digital delays to filthy dub echoes, ping-pong flangers, and broken cassette tapes. AUFX:PeakQ : A versatile 4-band parametric stereo equalizer for everything between subtle frequency enhancements and agressive boosting/cutting or special resonator effects.","title":"Kymatica.com"},{"location":"community/powered-by-faust/#nemesis","text":"Nemesis is multichannel dsp platform for eurorack. It can be programmed with Faust .","title":"Nemesis"},{"location":"community/powered-by-faust/#sonobus","text":"SonoBus is an easy to use application for streaming high-quality, low-latency peer-to-peer audio between devices over the internet or a local network. Several DSP effects ( Compressor , Expander , Limiter , ParametricEQ , Reverb ) have been written in Faust , compiled as C++ code, and included in the JUCE project .","title":"Sonobus"},{"location":"community/powered-by-faust/#xplugslv2","text":"This repository contain the LV2 plugins developed using libxputty/XUidesigner. The included makfile allows the build of all plugins against a single checkout of libxputty. Each plugin exists as its own submodule under this repository. Some of the DSP code has been written with Faust.","title":"XPlugs.lv2"},{"location":"community/powered-by-faust/#bass-preamp-drive","text":"The goal of this project is to digitally reproduce the behavior of a well-known electric bass preamp: Ampeg SVT3 Pro. This preamp has been copied by several manufacturers. So we have an almost perfect copy with the Bugera BVP5500 which has four preamplifier tubes. An analog copy is also available as a pedal, the Tech 21 BDDI. The project is based on advances in the simulation of analog circuits made available by the Guitarix project and the excellent Faust from Grame cncm.","title":"Bass Preamp Drive"},{"location":"community/powered-by-faust/#drum-module","text":"This project aims at integrating a digital drum synthesizer using Faust and Miosix real time OS on an STM32F407VG Discovery Board. To do this, a user interface by means of buttons, sliders, encoders, and an LCD has been implemented to control the synthesizer. Moreover, a serial MIDI input port has been added in order to control the synthesizer externally by using an external sequencer or controller.","title":"Drum Module"},{"location":"community/powered-by-faust/#daisy-based-audio-boards","text":"Daisy is an embedded platform for music. It features everything you need for creating high fidelity audio hardware devices. Just plug in a USB cable and start making sound! No soldering required. It can be programed with Faust using the faust2daisy tool.","title":"Daisy based audio boards"},{"location":"community/powered-by-faust/#elk-audio-os","text":"Elk is an Audio Operating System developed from the ground up to deliver real time audio performances in embedded systems and remote networks. It can run on several hardware . Faust can be used to generate VST2 plugins to run on the plaform.","title":"Elk Audio OS"},{"location":"community/powered-by-faust/#er-301-sound-computer","text":"The ER-301 is a voltage-controllable canvas for digital signal processing algorithms. It can be programed with Faust using the faust2er301 tool and some units are developed here . Note that it is still a WIP, read the discussion here .","title":"ER-301 Sound Computer"},{"location":"community/powered-by-faust/#zynthian-platform","text":"Zynthian is a new class of musical device. A powerful multitimbral synthesizer and audio processor, capable of managing up to 16 audio chains simultaneously. Also, it's a MIDI processor and router, equipped with standard MIDI ports, USB, WIFI & wired networks. Zynthian is a community-driven project and it's 100% open source. The Zynthian platform can be programmed with Faust with some DSP examples here .","title":"Zynthian platform"},{"location":"community/powered-by-faust/#gxpluginslv2","text":"GxPlugins.lv2 is a set of more than 40 extra standalone lv2 plugins designed to compliment the Guitarix project. Each plugin exists as its own submodule under this repository. The DSP code has been written with Faust.","title":"GxPlugins.lv2"},{"location":"community/powered-by-faust/#stone-phaser","text":"A classic analog phaser effect. This is an analog phaser with similarity to the Small Stone. It has a color switch, which makes the phasing stronger when on, and adds some feedback controls. A stereo variant of the phaser is included. This effect is supported on MOD devices. The DSP code is developed in Faust .","title":"Stone phaser"},{"location":"community/powered-by-faust/#sfizz","text":"sfizz is a sample-based musical synthesizer. It features the well-established SFZ instrument format at its core, which permits to use existing instrument libraries, or create personal instruments with ease. Not only is sfizz ready-to-use as an instrument plugin of its own, the library allows developers to create instruments of their own, taking advantage of the abilities of SFZ. The sfizz project uses the SFZ parser and synth c++ library, providing AU / LV2 / VST3 plugins and JACK standalone client. Some effects are developed in Faust are well as several filters .","title":"sfizz"},{"location":"community/powered-by-faust/#antescofo","text":"Antescofo is a coupling of a real-time listening machine with a reactive and timed synchronous language developed at IRCAM . The language is used for authoring of music pieces involving live musicians and computer processes, and the real-time system assures its correct performance and synchronization despite listening or performance errors. Antescofo audio DSP processes can be described with Faust , using libfaust dynamic version of the Faust compiler.","title":"Antescofo"},{"location":"community/powered-by-faust/#motion-vox","text":"A mobile music creation and performance workstation with a built-in motion-based controller, sequencer and synthesis engine. The controller unites XY pad, accelerometer and gyroscope events with complex data \ufb01ltering engine. Performance process consists of touching the active area on the screen with the index finger and moving the cursor while moving the device in space. Smartphone position in space and finger movement on a screen affect various parameters of sound or generate realtime MIDI output. The app was inspired by the SmartFaust project of GRAME. The audio engine of the app is made with FAUST.","title":"Motion Vox"},{"location":"community/powered-by-faust/#inscore","text":"INScore is an open source framework for the design of interactive, augmented, live music scores. Augmented music scores are graphic spaces providing representation, composition and manipulation of heterogeneous and arbitrary music objects (music scores but also images, text, signals...), both in the graphic and time domains. Audio DSP processes and effects can be described using Faust. The environment runs as a native application but also in the Web. Faust programs are only supported by the online version .","title":"INScore"},{"location":"community/powered-by-faust/#virtual-rhizome","text":"By Vincent Carinola . Virtual Rhizome responds to a proposal by Christophe Lebreton and Jean Geoffroy to compose a work for the original Smart Hand Computer system, developed at the GRAME-CNCM using the Faust language and allowing to play smartphones as an instrument. The work takes the form of a labyrinth, a kind of virtual architecture that could be compared to Borges' \"garden of branching paths\", within which the musician evolves by adapting his gestures to the constraints of different types of situations. Each situation is characterized by an autonomous functioning of the system, that the musician must apprehend in order to find the key allowing him to modify it and to move towards another situation. But in order to orientate himself well, he must create a mental representation of the structure of the work. The performer then becomes an explorer of a world that he unveils, but isn't that what he has always been? Virtual rhizome owes much to the availability and enthusiasm of Jean Geoffroy and Christophe Lebreton. It is amicably dedicated to them.","title":"Virtual Rhizome"},{"location":"community/powered-by-faust/#smartfaust","text":"SmartFaust is a concept of musical applications for smartphones. These applications have the particularity of only using the user's gestures and not by tapping on the device's screen. Made for iOS and Android, they can also use the motion sensors of these devices to make them real musical instruments. Smartfaust applications are based on the Faust (Functional Audio Stream) programming language developed by Grame over the last 15 years and recognized as a standard in the field of real-time signal processing for audio. The SmartFaust applications were first used for the creation of the pieces Mephisto (for drums and cell phone ensemble), Belzebuth (participative piece for public equipped with Smartphones), Iblis (for clarinet and cell phone ensemble) and B\u00e9lial (for harp and cell phone ensemble) written by the composer Xavier Garcia. From this same technology were later created the applications \"Geek Bagatelles\" (2016) and \"GameLan\" (2019). Download here: Android & iOS","title":"SmartFaust"},{"location":"community/powered-by-faust/#trombone-simulator","text":"This simulator is a physical model of a trombone. Physical models of the lips, mouthpiece, slide, and bell are digitally simulated. The controls are listed at the top. The main controls are to move the cursor (or your finger on a touch device) left and right on the picture to adjust the embouchure, and up and down to extend and retract the slide. The diagonal colored lines are a guide to where the resonances are: playing over a resonance means that the embouchure and slide length are matched. Playing over white space means that one is between resonances and the note quality won't be as good. The big gray wedge on the upper right indicates that the resonances are very close together there. The vertical dashed lines indicate the rough locations of B-flat (thick lines) and F (thin lines). Other notes are unmarked, and likewise the slide positions. (Just like on a real trombone!) The off-key resonances (7th, 11th, 13th, and 14th) are marked in red. The g and f keys can be used to growl and flutter-tongue, respectively. The audio simulation is written in Faust, which conveniently compiles to WebAssembly and a Web Audio API wrapper. The overall approach used was a digital waveguide model, as described in J. O. Smith III's Digital Waveguide Theory. The lips and bell are adapted from F. Scott's masters thesis.","title":"Trombone Simulator"},{"location":"community/powered-by-faust/#integrating-1-dof-force-feedback-interactions-in-self-contained-dmis","text":"By Mathias Kirkegaard . This thesis presents a system for designers of Digital Musical Instruments (DMIs) to explore the integration of 1 degree of freedom (DoF) force feedback interactions in new self-contained instruments. The system developed consists of an open-source graphical tool and a rotary force-feedback device made from commercially available components to facilitate the authoring of audio-haptic applications. Implementing an early prototype is used to inform the development of the graphical editing tool and its integration in an embedded audio-haptic environment using the functional programming language Faust for real-time signal processing.","title":"Integrating 1-DoF force feedback interactions in self-contained DMIs"},{"location":"community/powered-by-faust/#beyond-key-velocity-continuous-sensing-for-expressive-control-on-the-hammond-organ-and-digital-keyboards","text":"By Giulio Moro . In this thesis we seek to explore the potential for continuous key position to be used as an expressive control in keyboard musical instruments, and how pre- existing skills can be adapted to leverage this additional control. The nonlinear waveguide physical model of a flute has been developed in Faust.","title":"Beyond Key Velocity: Continuous Sensing for Expressive Control on the Hammond Organ and Digital Keyboards"},{"location":"community/powered-by-faust/#guide-de-la-synthese-sonore","text":"By Sebastien Clara . In this guide, I try to demystify how sound synthesis works. To do so, I present the fundamental principles of sound synthesis. I accompany these explanations with small sound applications that you can manipulate in your web browser and thus, you will be able to notice the impact of a parameter on the sound. Most of the sound examples are written in Faust and run in the web pages. This guide is currently only in french.","title":"Guide de la synth\u00e8se sonore"},{"location":"community/powered-by-faust/#pico-dsp","text":"PICO DSP is an open-source, Arduino-compatible ESP32 development board for audio and digital signal processing (DSP) applications. It offers an expansive audio-processing feature set on a small-format, breadboard-friendly device that provides audio inputs, audio outputs, a low-noise microphone array, an integrated test-speaker option, additional memory, battery-charge management, and ESD protection all on one tiny PCB. The board can be programmed using Faust .","title":"PICO DSP"},{"location":"community/powered-by-faust/#soundjack","text":"The Soundjack realtime communication application is extended by a server cloud to handle up to 60 musicians of an orchestra, developed with the Faust programming language. Each musician is connected to a Soundjack UDP client. An individual stereo mix of the multiple audio streams originating from the multiple Soundjack clients has to be provided to each listening musician. An extended presentation of the system can be found in this IFC 2018 paper .","title":"Soundjack"},{"location":"community/powered-by-faust/#studiox-switcher","text":"Studiox-switcher is an input switcher and silence detector for JACK. It can switch between 3 stereo inputs, a fallback channel is activated if the active input is below a volume threshold for some amount of seconds, and channels may be switched via OSC and HTTP. The core DSP engine is done via Faust for switching, silence detection and level metering.","title":"studiox-switcher"},{"location":"community/powered-by-faust/#synthspace","text":"Synthspace is the ultimate virtual synthesizer. It combines the familiarity of real instruments with the possibilities of virtual worlds. Nodes for Synthspace can be developed in Faust .","title":"SynthSpace"},{"location":"community/powered-by-faust/#bass21","text":"This VST3 is a virtual-analog simulation of the famous Bass Driver DI Version 1 preamp pedal from Tech21. The discretization, while far from being exact, is moderately close to the original. The potentiometers are identical to these physically present on the BDDI pedal, apart from the pregain which is specific to this digital version. The DSP code is written in Faust.","title":"Bass21"},{"location":"community/powered-by-faust/#echomatrix","text":"The EchoMatrix was designed to provide some of the functionality of the Yamaha UD Stomp pedal as used be Alan Holdsworth. This project will be submitted to the KVR Developer Challenge 2021 contest to highlight the power of the Faust DSP development environment and the JUCE framework to create a non-trivial effect VST3 using a managable amount of Faust DSP code .","title":"EchoMatrix"},{"location":"community/powered-by-faust/#the-striso-board","text":"The Striso board is a very expressive music instrument which combines multidimensionally sensitive keys with an innovative note layout that helps understand the structures in music. The keys capture each subtle finger movement, which allows for levels of musical expression previously only known to acoustic instruments. Additionally, accents and sound effects can be added by shaking and moving the instrument as a whole. The internal sound is written in Faust, and is controlled directly by the signals from the keys and motion sensor. External synthesizers can be controlled using MPE MIDI, or using OSC which is easier to set up for Faust synthesizers. The firmware source code is released as open source.","title":"The Striso board"},{"location":"community/powered-by-faust/#live-concatenative-granular-processing","text":"This algorithm addresses signal discontinuity and concatenation artefacts in real-time granular processing with rectangular windowing. By combining zero-crossing synchronicity, first-order derivative analysis, and Lagrange polynomials, we can generate streams of uncorrelated and non-overlapping sonic fragments with minimal low-order derivatives discontinuities. The resulting open-source algorithm, implemented in the Faust language, provides a versatile real-time software for dynamical looping, wavetable oscillation, and granulation with reduced artefacts due to rectangular windowing and no artefacts from overlap-add-to-one techniques commonly deployed in granular processing.","title":"Live concatenative granular processing"},{"location":"community/powered-by-faust/#fb_suppression","text":"ALS - Automatic Larsen Suppression algorithms implementing adaptive filtering through spectral centroid calculation, and adaptive frequency shifting through RMS calculation.","title":"fb_suppression"},{"location":"community/powered-by-faust/#ossia-score","text":"Ossia score is a sequencer for audio-visual artists, designed to enable the creation of interactive shows, museum installations, intermedia digital artworks, interactive music and more in an intuitive user interface. Faust can be used to create advanced audio processes . A demo video of the Faust integration can be seen here .","title":"ossia score"},{"location":"community/powered-by-faust/#faselunare-microcosmos","text":"Microcosmos is a small open-source electronic board, developed by \u200bFaselunare (Italy), aimed at prototyping electronic musical instruments and learning electronics, microcontroller programming and audio DSP, and programmable with Faust. A demo video of the project can be seen here . The project has been presented at ADC21 .","title":"FASELUNARE Microcosmos"},{"location":"community/powered-by-faust/#audio-anywhere","text":"The goal of Audio Anywhere is to explore the idea of compile once, run anywhere for audio DSP code. Audio Anywhere combines Faust, for audio DSP code, and HTML5 to enable development of modern audio synthesis and effects tools. There are currently three main repos for this work: AA examples AA standalone app AA Wasmtime runtime","title":"Audio Anywhere"},{"location":"community/powered-by-faust/#the-keywi","text":"An Expressive and Accessible Electronic Wind Instrument, where the sound is synthesized with Faust running on the Bela Mini processing board.","title":"The KeyWi"},{"location":"community/powered-by-faust/#react-web-audio-guitar-studio","text":"React Web Audio Guitar Studio is an online real-time Web Audio based all-in-one guitar studio, using native plugins written on Faust, compiled on-demand, and ran in a browser.","title":"React Web Audio Guitar Studio"},{"location":"community/powered-by-faust/#jspatcher","text":"JSPatcher is a Visual Programming Language (VPL) in Max/PureData style on the web with following features: Patch WebAudio native AudioNodes Play with JavaScript Web APIs Import and patch external JavaScript modules Customize AudioWorklet DSPs with Faust A presentation video can be seen here .","title":"JSPatcher"},{"location":"community/powered-by-faust/#gwion","text":"Gwion is a programming language aimed at making music. It is strongly inspired by ChucK and can use a set of plugins for Gwion . One allows to use the libfaust library to JIT compile and run DSP code on the fly. The faust2gw tool allows to produce statically compiled modules.","title":"Gwion"},{"location":"community/powered-by-faust/#sonejostudios","text":"A set of tools written using Faust.","title":"sonejostudios"},{"location":"community/powered-by-faust/#panoramix","text":"Stereo Panorama/Balance and Volume Automation Tool.","title":"Panoramix"},{"location":"community/powered-by-faust/#mixer4x","text":"A simple 4-channel stereo mixer. The main goal is to use it as a submixer on a 4 channel track, but you can use it everywhere you need a small 4 channel stereo mixer.","title":"Mixer4x"},{"location":"community/powered-by-faust/#faustdrumseq","text":"A very simple drum sequencer written with Faust, using the new soundfile object.","title":"faustdrumseq"},{"location":"community/powered-by-faust/#midiclockclick","text":"A simple metronom driven by MidiClock.","title":"MidiClockClick"},{"location":"community/powered-by-faust/#superbeatrepeater","text":"Beat Repeater with Sidechain Beat Recognation and Midi-Clock Sync. Very useful i.e to add musical diversity by looping short parts of the stream (i.e drums).","title":"SuperBeatRepeater"},{"location":"community/powered-by-faust/#supercutsequencer","text":"Cut \"On/Off\" Sequencer (8 steps with smooth) synced to Midi-Clock Beats and Midi-Clock Start/Stop. Very useful i.e to add musical diversity in looped tracks (very nice with i.e bass lines).","title":"SuperCutSequencer"},{"location":"community/powered-by-faust/#delooper","text":"Sample-accurate Looper/Delay with free mode and midi-clock sync mode.","title":"DeLooper"},{"location":"community/powered-by-faust/#xymatrix","text":"XY Surround Matrix for one Source (Mono Input) with 4 Outputs (Left, Right, Surround Left, Surround Right) and Position Lock.","title":"XYMatrix"},{"location":"community/powered-by-faust/#stm32-faust-synth","text":"STM32 synthesizer video is a short presentation of a polyphonic synthesizer based on STM32F405 \u00b5C. Faust is used for signal processing and a TLV320AIC23B stereo codec serves as DAC. Another more recent video is here .","title":"stm32-faust-synth"},{"location":"community/powered-by-faust/#faustgen2","text":"The faustgen2~ object is a Faust external for Pd a.k.a. Pure Data , Miller Puckette's interactive multimedia programming environment.","title":"faustgen2~"},{"location":"community/powered-by-faust/#amati","text":"Amati is a VST plugin for live-coding effects in the Faust programming language. As of now it only provides basic functionality.","title":"Amati"},{"location":"community/powered-by-faust/#puretones","text":"PureTones PureTones is a family of software tools for Indian Classical music. They are built based on an in-depth study and exploration of Indian Classical music to understand the role of harmonics, microtones and consonance in Indian Ragas and musical scales: PureTones Drone (using first tab) , is a digital Tanpura with controls for fine tuning the strings and adjusting their harmonic envelope. PureTones Musical Scale (using second tab) is a digital 12 note keyboard with controls for fine tuning each key to be consonant with an accompanying drone track. PureTones Sequencer (using third tab) is a sequencer which enables composition of melodies and musical works in Indian Classical music using notes from a fine tuned musical scale. The Ragatronics project combines Ragas from Indian Classical music with elements from Rock, Jazz and Electronic music. All applications have been developed using Faust and WebAudio tools.","title":"PureTones"},{"location":"community/powered-by-faust/#making-sound-machines","text":"Making Sound Machines are a duo of makers from D\u00fcsseldorf, Germany. We build kits, modules and DIY projects, and use the projects we\u2019ve built to make music. Faust is used in several projects.","title":"Making Sound Machines"},{"location":"community/powered-by-faust/#master_me","text":"Automatic audio mastering plugin for live-streaming, podcasting and internet radio stations. With the first Covid-19 related lock-downs in 2020, many real-life concerts, conferences and festivals were forced into the digital domain - and sounded pretty crappy. Having worked for almost 20 years in audio mastering, Berlin based engineer Klaus Scheuermann started to develop master_me - a word fusion of automatic mastering and mini-me - in order to make open source streaming sound better. After a few weeks of learning and development, master_me was first used at the 'Quarantine Sessions' - a weekly distributed electro-acoustic improvised concert, hosted at Stanford's CCRMA Institute. master_me was developed further to be an easy-to-use tool for all live streaming applications. In 2022 it was funded by the Prototype Fund, an open source software funding initiative by the german ministry of education and research. A stable release is available since September 2022.","title":"master_me"},{"location":"community/powered-by-faust/#metasurface64","text":"metaSurface64 is a real-time continuous sound transformation control surface that features both its own loop generator for up to 64 voices and a multi-effects FX engine. The application embeds the libfaust dynamic version of the Faust compiler.","title":"metaSurface64"},{"location":"community/powered-by-faust/#fragment-audio-server-and-fragment","text":"Fragment Audio Server (FAS) is a high performance pixels-based graphical audio synthesizer implemented as a WebSocket server with the C language (C11). Faust , is embedded (when compiled with WITH_FAUST ) and allow to dynamically extend FAS bank generators and effects with custom one written with the Faust DSP specification language. FAS is the audio engine used in Fragment , the Collaborative Graphical Audio Synthesizer. Follow the demo here .","title":"Fragment Audio Server and Fragment"},{"location":"community/powered-by-faust/#swanky-amp","text":"Swanky Amp is a tube amplifier simulation DSP plugin which aims to capture the details in the dynamics of tube amplifiers. The DSP is primarily written in Faust , whereas the UI is written in C++ using the JUCE . Follow the demo here . A commercial version is available here .","title":"Swanky Amp"},{"location":"community/powered-by-faust/#web-synth","text":"This is a web-based DAW (Digital Audio Workstation) written in Rust/WebAssembly and TypeScript with extensive Faust language integration with dynamic remote code compilation and executing via WebAssembly. Follow the demo here .","title":"Web Synth"},{"location":"community/powered-by-faust/#dawdreamer","text":"DawDreamer is an audio-processing Python framework supporting core DAW features such as audio playback, VST MIDI instruments, VST effects, Faust , and parameter automation. DawDreamer is written with JUCE , with a user-friendly Python interface thanks to pybind11 . DawDreamer draws from an earlier VSTi audio \"renderer\", RenderMan .","title":"DawDreamer"},{"location":"community/powered-by-faust/#td-faust","text":"TD-Faust enables Faust code to run inside TouchDesigner . Follow the demo here .","title":"TD-Faust"},{"location":"community/powered-by-faust/#mephisto-lv2","text":"Mephisto LV2 a Just-in-Time Faust compiler embedded in an LV2 plugin. Write LV2 audio/cv instruments/filters directly in your host in Faust DSP language without any need to restart/reload host or plugin upon code changes.","title":"Mephisto LV2"},{"location":"community/powered-by-faust/#iplug2","text":"iPlug 2 is a simple-to-use C++ framework for developing cross platform audio plug-ins/apps and targeting multiple plug-in APIs with the same minimalistic code, support for the Faust programming language, and the libfaust JIT compiler.","title":"iPlug2"},{"location":"community/powered-by-faust/#pmix","text":"pMix (short for preset mixer) is a sound design, composition and performance tool that facilitates the control of multiple parameters using an intuitive graphical interface. It includes a graphical patcher for creating a network of audio synthesis or processing nodes. A node could be a VST2, VST3, AU or LADSPA plug-in or it could a JIT compiled FAUST script. FAUST is a first class citizen in pMix and an integrated code editor and SVG display makes it a nice environment for FAUST development.","title":"pMix"},{"location":"community/powered-by-faust/#temper-juce-plugin","text":"Temper is a digital distortion audio plugin targeting VST, VST3, and AU for OS X and Windows. It builds upon traditional waveshaping techniques using modulated filter coefficients to produce a unique phase distortion. The primary signal processing loop is written with Faust, and compiled with JUCE for the various build targets.","title":"Temper JUCE plugin"},{"location":"community/powered-by-faust/#faust-mass-interaction","text":"mi_faust implements 1D mass-interaction models in the FAUST programming language. Starting from a scripted model description (see MIMS), mi_faust compiles a physical model into FAUST code. It handles this by generating routing functions between all the masses and all the interactions in the model. Head over to the FAUST community page to see examples of a series of instruments created in mi_faust, and available as web-apps !","title":"Faust Mass-Interaction"},{"location":"community/powered-by-faust/#dynamic-pedalboard","text":"Dynamic PedalBoard allows users to plug different stompboxes together in a web browser.","title":"Dynamic PedalBoard"},{"location":"community/powered-by-faust/#sharc-dsp-board","text":"The ADI SHARC DSP board fully supports Faust.","title":"SHARC DSP Board"},{"location":"community/powered-by-faust/#nuance","text":"Nuance is a pressure sensitive music controller that uses Faust for sound synthesis and processing.","title":"Nuance"},{"location":"community/powered-by-faust/#the-plateaxe","text":"The PlateAxe is a percussion instrument physical model controller using Faust for sound synthesis and processing.","title":"The PlateAxe"},{"location":"community/powered-by-faust/#the-bladeaxe","text":"The BladeAxe is an electric guitar physical model controller using Faust for sound synthesis and processing.","title":"The BladeAxe"},{"location":"community/powered-by-faust/#bart-brouns-projects","text":"A collection of projects by Bart Brouns and based on Faust.","title":"Bart Brouns' Projects"},{"location":"community/powered-by-faust/#eartone-toolbox","text":"The Ear Tone Toolbox is a collection of unit generators for the production of auditory distortion product synthesis.","title":"EarTone Toolbox"},{"location":"community/powered-by-faust/#audiokit","text":"AudioKit allows developers to quickly add professional audio functionality to iOS, macOS, and Apple Watch apps.","title":"AudioKit"},{"location":"community/powered-by-faust/#radium","text":"Radium is a music editor with a new type of interface. It includes a Faust audio DSP development environment. Compared to the normal sequencer interface editing is quicker and more musical data fits on the screen. Compared to trackers, note positions and effects are edited graphically, which should be quicker, provide more vertical space and give a better musically overview. (Everything can also be edited by text, like in a normal tracker) Radium can also be used as a normal multitracker to mix and record audio.","title":"Radium"},{"location":"community/powered-by-faust/#bela","text":"Bela is a maker platform for creating beautifully responsive audio and interactive applications. Designed for artists, musicians, researchers and makers, Bela brings the power of ultra-low latency interactive audio and sensors to your digital projects. It can be programmed with Faust .","title":"BELA"},{"location":"community/powered-by-faust/#hoa-library","text":"HOA Library allows musicians and composers to synthesize, transform and render sound fields in a creative and artistic way. This library facilitates the understanding and the appropriation of key concepts of ambisonics. Thanks to original graphical interfaces a lot of new signal processings are allowed like diffuse sound field synthesis, perspective distorsion or spatial filtering. HOA library is open-source and free and offers a set of C++ and FAUST classes and implementation for Max, PureData and Unity.","title":"HOA Library"},{"location":"community/powered-by-faust/#ambitools","text":"Ambitools is a collection of plug-ins and tools for 3D sound field synthesis using Higher Order Ambisonics (HOA). The plugins are written in the Faust language , which allows them to be compiled for a multitude of architectures and platforms (Windows, Mac, Linux, WebAudio, embedded systems, etc.) Moreover, the code is written in a scalable way: there is no limit to the maximum Ambisonic order! Other tools are also available, such as a 3D Visualizer written in the Processing language.","title":"Ambitools"},{"location":"community/powered-by-faust/#ambisonic-decoder-toolbox","text":"The Ambisonic Decoder Toolbox is a collection of MATLAB and GNU Octave functions for creating Ambisonic Decoders. Currently, it implements: (1) the AllRAD design technique, (2) inversion or mode-matching, (3) truncated mode-matching, constant energy, (4) linear combinations of 2 and 3, and (5) Slepian function basis (EPAD). The DSP code is written in MATLAB and Faust.","title":"Ambisonic Decoder Toolbox"},{"location":"community/powered-by-faust/#ambisonicxyz","text":"A set of tools around Ambisonics.","title":"Ambisonic.xyz"},{"location":"community/powered-by-faust/#faustpy","text":"FaustPy is a Python wrapper for Faust. It is implemented using the CFFI and hence creates the wrapper dynamically at run-time.","title":"FaustPy"},{"location":"community/powered-by-faust/#rebel-technology","text":"The OWL Pedal is an open source, programmable stage effects pedal, made for guitarists, musicians, hackers and programmers. Users can program their own effects, or download ready-made patches from our growing online patch library.","title":"Rebel Technology"},{"location":"community/powered-by-faust/#faust-vst","text":"This project provides a VST plugin architecture for the Faust programming language. The package contains the Faust architecture, faustvst.cpp, the faust2faustvst helper script which provides a quick way to compile a plugin, a collection of sample plugins written in Faust, and a generic GNU Makefile for compiling and installing the plugins.","title":"faust-vst"},{"location":"community/powered-by-faust/#faust-lv2","text":"This project provides an LV2 plugin architecture for the Faust programming language. The package contains the Faust architecture and templates for the needed LV2 manifest (ttl) files, a collection of sample plugins written in Faust, and a generic GNU Makefile as well as a shell script to compile plugins using the architecture.","title":"faust-lv2"},{"location":"community/powered-by-faust/#rdk","text":"Reverb Design is about creating a spacial impression aimed at sweetening the listening experience for a given context. The ambiguity of auditory and visual cues in reproduced sound makes it necessary to create an auditory illusion: To make this illusion work, I propose an aesthetic concept of simplicity and intelligibility based on psychoacoustic facts and recording practice as professional producer.","title":"RDK"},{"location":"community/powered-by-faust/#foo-yc20","text":"The Foo YC20 is an open source implementation of the Yamaha YC-20 combo organ from 1969. Processing for the organ is based on original schematics and measurements from a working specimen. This instrument simulates the circutry as a whole to realisticly reproduce the features and flaws of the real deal.","title":"Foo YC20"},{"location":"community/powered-by-faust/#fauck","text":"FaucK is a Chugin allowing to combine the powerful, succinct Functional AUdio STream (Faust) language with the strongly-timed ChucK audio programming language. FaucK allows programmers to on-the-fly evaluate Faust code directly from ChucK code and control Faust signal processors using ChucK's sample-precise timing and concurrency mechanisms. The goal is to create an amalgam that plays to the strengths of each language, giving rise to new possibilities for rapid prototyping, interaction design and controller mapping, pedagogy, and new ways of working with both Faust and ChucK.","title":"FaucK"},{"location":"community/powered-by-faust/#snd-rt","text":"Snd-RT is the realtime extension for the sound editor SND and consists of two parts: the RT Engine - An engine for doing realtime signal processing. the RT Compiler - A compiler for a scheme-like programming language to generate realtime-safe code understood by the RT Engine.","title":"Snd-RT"},{"location":"community/powered-by-faust/#pure-language","text":"[Pure is a modern-style functional programming language based on term rewriting. It offers equational definitions with pattern matching, full symbolic rewriting capabilities, dynamic typing, eager and lazy evaluation, lexical closures, built-in list and matrix support and an easy-to-use C interface. The interpreter uses LLVM as a backend to JIT-compile Pure programs to fast native code. It has been created by Albert Gr\u00e4f. pd-faust is a collection of Pd objects written using pd-pure which lets you run Faust programs inside Pd. It combines the functionality of pure-faust and faust2pd in a single package, and also features dynamic reloading of Faust plugins, automatic generation of controller GUIs and MIDI/OSC controller mappings, as well as OSC-based controller automation. It thus provides a complete solution for interactively developing Faust dsps in Pd.","title":"Pure Language"},{"location":"community/powered-by-faust/#guitarix","text":"An audio plug-in for guitar effects whose sound processing engine is written in Faust.","title":"Guitarix"},{"location":"community/powered-by-faust/#moforte-geoshred","text":"An electric guitar app using physical modeling. Faust was used to implement its sound synthesis/processing engine.","title":"moForte GeoShred"},{"location":"community/powered-by-faust/#moforte-powerstomp","text":"An app implementing various guitar effects to be used on stage.","title":"moForte PowerStomp"},{"location":"community/powered-by-faust/#moforte-guitar","text":"An app that can be used as an electric guitar and whose sound synthesis engine is implemented in Faust.","title":"moForte Guitar"},{"location":"community/powered-by-faust/#faustworks","text":"FaustWorks is an IDE (Integrated Development Environment) for the Faust dsp programming language. You must have Faust installed to be able to use FaustWorks. Platforms supported are Linux and OSX.","title":"FaustWorks"},{"location":"community/powered-by-faust/#faustlive","text":"FaustLive is an advanced self-contained prototyping environment for the Faust programming language with an ultra-short edit-compile-run cycle. Thanks to its fully embedded compilation chain, FaustLive is simple to install and doesn't require any external compiler, development toolchain or SDK to run. FaustLive is the ideal tool for fast prototyping. Faust programs can be compiled and run on the fly by simple drag and drop. They can even be edited and recompiled while running, without sound interruption. It supports also native applications generation using the Faust online compiler. FaustLive is based on the Faust library and on LLVM. \u200b","title":"FaustLive"},{"location":"community/press/","text":"Faust in the Press 2018 CDM, Vadim is a master of the dark arts of DSP \u2013 listen to him explain filters , October 19, 2018. France Musique, Bernard Cavanna, compositeur agit\u00e9 ! - Albums \"\u00c0 l\u2019agit\u00e9 du bocal\" & \"Le caillou dans la chaussure\" , October 10, 2018. BNEWS, \u0426\u0438\u0444\u0440\u043e\u0432\u0430\u044f \u043e\u0441\u0435\u043d\u044c \u0432 \u0410\u043b\u043c\u0430\u0442\u044b: \u041c\u043e\u043b\u043e\u0434\u044b\u0435 \u043c\u0443\u0437\u044b\u043a\u0430\u043d\u0442\u044b \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u043b\u0438 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u0433\u0430\u0434\u0436\u0435\u0442\u043e\u0432 , October 18, 2018. iProfesional, Una orquesta sinf\u00f3nica dara un concierto en Buenos Aires junto a un coro de \"smartphones\" , October 06, 2018. SWR Aktuell Rheinland-Pfalz, Programmiersprache macht digitale T\u00f6ne , July 17, 2018. Deutschlandfunk, F\u00fcr einen Mathematiker ist das der Himmel , July 21, 2018. Deutschlandfunk, Radio-Premiere f\u00fcr die Zarenglocke , July 21, 2018. Piekary, Ch\u00f3r\u2026smarfon\u00f3w w Filharmonii \u015al\u0105skiej , May 10, 2018. Tribune de Gen\u00e8ve, Quand smartphones et orchestre s\u2019accordent , March 22, 2018. MDR Th\u00fcringen, Jenaer Philharmonie spielt Smartphone-Konzert , February 26, 2018. iDNES.cz, VIDEO: Filharmonici p\u0159izvali na p\u00f3dium studenty, zahr\u00e1li na sv\u00e9 mobily , February 16, 2018. 2017 Le Dauphin\u00e9 Lib\u00e9r\u00e9, https://www.ledauphine.com/isere-nord/2017/10/28/rejoignez-l-orchestre-de-smartphones , October 28, 2017. Wired.it, Geek Bagatelles, il concerto per orchestra e smartphone , October 18, 2017. Tecnologia, Geek Bagatelles. Al Romaeuropa Festival il concerto per orchestra e coro di smartphone , October 12, 2017. Capital avec Management, Musique et Entreprise : la M\u00e9thode Gagnante de la Soci\u00e9t\u00e9 G\u00e9n\u00e9rale , April 17, 2017. France Info, Fl\u00fbte pr\u00e9historique et ch\u0153ur de smartphones, l\u2019Orchestre de Picardie innove , February 07, 2017. France Info, La smartophonie : quand le portable devient instrument de musique , January 24, 2017. 2016 France Info, SmartFaust, l'application qui transforme les portables en instruments , December, 6, 2016. Le Parisien, \"SmartFaust\", des applis pour jouer de la musique avec son portable , March 26, 2016.","title":"Press"},{"location":"community/press/#faust-in-the-press","text":"","title":"Faust in the Press"},{"location":"community/press/#2018","text":"CDM, Vadim is a master of the dark arts of DSP \u2013 listen to him explain filters , October 19, 2018. France Musique, Bernard Cavanna, compositeur agit\u00e9 ! - Albums \"\u00c0 l\u2019agit\u00e9 du bocal\" & \"Le caillou dans la chaussure\" , October 10, 2018. BNEWS, \u0426\u0438\u0444\u0440\u043e\u0432\u0430\u044f \u043e\u0441\u0435\u043d\u044c \u0432 \u0410\u043b\u043c\u0430\u0442\u044b: \u041c\u043e\u043b\u043e\u0434\u044b\u0435 \u043c\u0443\u0437\u044b\u043a\u0430\u043d\u0442\u044b \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u043b\u0438 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u0433\u0430\u0434\u0436\u0435\u0442\u043e\u0432 , October 18, 2018. iProfesional, Una orquesta sinf\u00f3nica dara un concierto en Buenos Aires junto a un coro de \"smartphones\" , October 06, 2018. SWR Aktuell Rheinland-Pfalz, Programmiersprache macht digitale T\u00f6ne , July 17, 2018. Deutschlandfunk, F\u00fcr einen Mathematiker ist das der Himmel , July 21, 2018. Deutschlandfunk, Radio-Premiere f\u00fcr die Zarenglocke , July 21, 2018. Piekary, Ch\u00f3r\u2026smarfon\u00f3w w Filharmonii \u015al\u0105skiej , May 10, 2018. Tribune de Gen\u00e8ve, Quand smartphones et orchestre s\u2019accordent , March 22, 2018. MDR Th\u00fcringen, Jenaer Philharmonie spielt Smartphone-Konzert , February 26, 2018. iDNES.cz, VIDEO: Filharmonici p\u0159izvali na p\u00f3dium studenty, zahr\u00e1li na sv\u00e9 mobily , February 16, 2018.","title":"2018"},{"location":"community/press/#2017","text":"Le Dauphin\u00e9 Lib\u00e9r\u00e9, https://www.ledauphine.com/isere-nord/2017/10/28/rejoignez-l-orchestre-de-smartphones , October 28, 2017. Wired.it, Geek Bagatelles, il concerto per orchestra e smartphone , October 18, 2017. Tecnologia, Geek Bagatelles. Al Romaeuropa Festival il concerto per orchestra e coro di smartphone , October 12, 2017. Capital avec Management, Musique et Entreprise : la M\u00e9thode Gagnante de la Soci\u00e9t\u00e9 G\u00e9n\u00e9rale , April 17, 2017. France Info, Fl\u00fbte pr\u00e9historique et ch\u0153ur de smartphones, l\u2019Orchestre de Picardie innove , February 07, 2017. France Info, La smartophonie : quand le portable devient instrument de musique , January 24, 2017.","title":"2017"},{"location":"community/press/#2016","text":"France Info, SmartFaust, l'application qui transforme les portables en instruments , December, 6, 2016. Le Parisien, \"SmartFaust\", des applis pour jouer de la musique avec son portable , March 26, 2016.","title":"2016"},{"location":"community/publications/","text":"Academic Publications Around Faust This page presents a non-exhaustive list of publications around the Faust programming language. If you think one of your papers is missing, let us know and we'll add it! menuholder","title":"Academic Publications"},{"location":"community/publications/#academic-publications-around-faust","text":"This page presents a non-exhaustive list of publications around the Faust programming language. If you think one of your papers is missing, let us know and we'll add it!","title":"Academic Publications Around Faust"},{"location":"community/publications/#menuholder","text":"","title":"menuholder"},{"location":"community/sponsors/","text":"Faust Sponsors","title":"Sponsors"},{"location":"community/sponsors/#faust-sponsors","text":"","title":"Faust Sponsors"}]}
\ No newline at end of file
diff --git a/docs/sitemap.xml.gz b/docs/sitemap.xml.gz
index 1a7800ae8c64219f8d6855edd66161159b2512ce..35181cecbb0eb8b4f08635852b19780e4b40688e 100644
GIT binary patch
delta 13
Ucmb=gXP58h;1Ir|Gm*Ul02<K);{X5v

delta 13
Ucmb=gXP58h;J9=`c_MoS03PcEjQ{`u

diff --git a/mkdocs/docs/community/powered-by-faust.md b/mkdocs/docs/community/powered-by-faust.md
index dcf93a08f..9f2db10a4 100644
--- a/mkdocs/docs/community/powered-by-faust.md
+++ b/mkdocs/docs/community/powered-by-faust.md
@@ -2,6 +2,11 @@
 
 This page lists the projects using Faust in different ways: musical pieces or artistic projects, plugins or standalone applications, integration in audio programming environments, development tools, commercial applications, research projects (possibly non musical), embedded devices, Web applications, etc.
 
+## [Faust in Cables.jl](https://av.tib.eu/media/67445)
+
+<div><a href="https://av.tib.eu/media/67445"><img width="50%" class="mx-auto d-block" src="img/faust-cables.jpg"></a> </div>
+
+Explore the dynamic integration of the Faust audio library within Cables in this video. This segment delves into the intricacies of generating rich audio experiences on the web, leveraging Faust's advanced capabilities for real-time audio synthesis with synthesizers and oscillators. Discover how to seamlessly compile, modify, and visualize audio within Cables, enhancing your projects with intricate audio-visual synchronization and interactive controls, inviting viewers to contribute and experiment with this powerful tool.
 
 ## [polyBLEP HOLE](https://patchstorage.com/polyblep-hole/)
 
diff --git a/mkdocs/docs/community/powered-by-faust/img/faust-cables.jpg b/mkdocs/docs/community/powered-by-faust/img/faust-cables.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c71f04032f5c81d26ae2b95303f065464510c18e
GIT binary patch
literal 162688
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
Xhm3L!;!|=)@?wfnzmvYu=KoCqAX-r@

literal 0
HcmV?d00001