Cymhwysiad Recordio Cerddoriaeth Aml-Drac — Version 0.1.1
2026-04-13
Mae Musician's Canvas yn gymhwysiad recordio cerddoriaeth aml-drac ar gyfer cyfrifiaduron bwrdd gwaith. Mae'n cefnogi recordio sain o feicroffonau a dyfeisiau line-in, recordio MIDI o fysellfyrddau a rheolyddion, a chymysgu'r holl draciau i ffeil WAV neu FLAC sengl. Mae cymhwysiad cydymaith, Virtual MIDI Keyboard, yn darparu bysellfwrdd piano meddalwedd ar gyfer anfon nodau MIDI.
Mae Musician's Canvas wedi'i ddylunio ar gyfer hawster defnydd tra'n darparu nodweddion a geir yn gyffredin mewn gorsafoedd gwaith sain digidol (DAWs):
Rhedwch y ffeil weithredadwy musicians_canvas o'r cyfeiriadur adeiladu neu eich lleoliad gosod:
./musicians_canvas
Ar y lansiad cyntaf, mae'r cymhwysiad yn agor gyda phrosiect gwag. Bydd angen i chi osod cyfeiriadur prosiect cyn recordio.
Ar gychwyn, mae'r cymhwysiad yn cymhwyso'r thema a gadwyd (tywyll neu olau) ac, os defnyddiwyd cyfeiriadur prosiect o'r blaen ac mae'n cynnwys ffeil project.json, mae'r prosiect yn cael ei lwytho'n awtomatig.
Gosodwch y cyfeiriadur prosiect: Rhowch neu porwch i ffolder yn y maes "Project Location" ar frig y ffenestr. Dyma lle bydd recordiadau a'r ffeil prosiect yn cael eu storio.
Ychwanegwch drac: Cliciwch y botwm + Add Track. Mae trac newydd yn ymddangos gyda gosodiadau rhagosodedig. Os mai dyma'r unig drac yn y prosiect ac nad yw wedi'i recordio eto, mae'n cael ei arfogi'n awtomatig ar gyfer recordio.
Enwch y trac: Teipiwch enw yn y maes testun wrth ymyl y botwm "Options". Defnyddir yr enw hwn fel enw ffeil ar gyfer y ffeil sain a recordiwyd.

Yn union o dan y bar dewislen mae bar offer gyda botymau mynediad cyflym:

Mae'r ffeil prosiect (project.json) yn storio enwau traciau, mathau, nodau MIDI, cyfeiriadau ffeiliau sain, a'r holl osodiadau sy'n benodol i'r prosiect. Mae ffeiliau sain yn cael eu storio yn yr un cyfeiriadur â project.json ac yn cael eu henwi ar ôl eu traciau (e.e., My_Track.flac).
Os byddwch yn cau'r cymhwysiad gyda newidiadau heb eu cadw, mae deialog gadarnhau yn gofyn a ydych am gadw cyn gadael.
Tra bod prosiect ar agor, gallwch lusgo un neu fwy o ffeiliau sain a gefnogir o'ch rheolwr ffeiliau (Windows Explorer, macOS Finder, rheolwr ffeiliau Linux, ac ati) yn uniongyrchol i ffenestr Musician's Canvas i'w hychwanegu fel traciau sain newydd.
.wav a .flac. Caiff ffeiliau mewn unrhyw
fformat arall eu hepgor yn dawel, ac mae deialog ar y diwedd yn rhestru pa
ffeiliau a hepgorwyd.Bass Line.wav yn creu trac sain
o'r enw "Bass Line".Gellir ffurfweddu pob trac fel Audio (ar gyfer recordio meicroffon/line-in) neu MIDI (ar gyfer recordio bysellfwrdd/rheolydd).
I newid y math trac:
Mae hyn yn agor y ddeialog Ffurfweddu Trac lle gallwch ddewis y ffynhonnell fewnbwn.

Mae pob rhes trac yn darparu'r rheolaethau canlynol:
Pan fo gan brosiect un trac yn union ac nad yw'r trac hwnnw wedi'i recordio eto, mae'n cael ei arfogi'n awtomatig ar gyfer recordio. Mae hyn yn berthnasol wrth ychwanegu'r trac cyntaf at brosiect newydd ac wrth agor prosiect presennol sydd ag un trac gwag.
Mae'r sain a recordiwyd yn cael ei chadw fel ffeil FLAC yn y cyfeiriadur prosiect, wedi'i enwi ar ôl y trac.
Yn ystod recordio a chwarae'n ôl, mae'r holl reolaethau rhyngweithiol (botymau traciau, gosodiadau, ayyb) wedi'u hanalluogi i atal newidiadau damweiniol.
Mae botwm Effeithiau ar draciau sain union dan Options. Mae'n agor y ddeialog Effeithiau trac, lle rydych chi'n adeiladu cadwyn wedi'i threfnu o effeithiau mewnosod ar gyfer recordio ar y trac hwnnw:

Mae Reverb, Chorus, Flanger, Overdrive / distortion, Amp & cabinet (modelu amplyffydd a chabinet: math o amplyffydd, cabinet, ennill, bas/canol/uchel, awyr a chymysgu) a Vibrato (Tremolo) ar gael.
Mae Vibrato (Tremolo) yn “Vibrato” clasurol Fender (tremolo mewn gwirionedd): modiwleiddio cyfaint cyfnodol. Mae Speed yn gosod cyflymder y pwls, a Intensity (Depth) yn gosod y dyfnder (o symudiad cynnil i “chop” llawn).
Sgrinluniau'r effaith Amp & cabinet:


Cynnir effeithiau pan fyddwch chi'n stopio recordio, ar ôl cipio ac ailsampla fel arfer. Mae'r ffurfweddiad yn cael ei gadw yn project.json dan audioEffectChain.
Project → Project Settings → Mix Effects lets you build the same kind of ordered effect chain as Track effects (Reverb, Chorus, Flanger, Overdrive / distortion, Amp & cabinet, Vibrato (Tremolo)), but applied to the entire mixed program: when you press Play to hear all enabled tracks together, and when you export with Mix tracks to file (toolbar or Tools menu). The chain is saved in project.json under projectSettings → mixEffectChain.
Project → Project Settings → Aux / Send Bus configures a shared effect chain fed by each track’s Aux send slider (on the track row). The dry mix of all tracks is summed, each track’s post-gain/post-pan signal is scaled by its Aux level and sent through this bus, then the wet aux output is added back to the dry sum before Mix Effects run. Use it for a single shared reverb/delay while keeping per-track insert effects independent.
To reduce harsh digital clipping when processing pushes peaks toward full scale, the effect engine applies a soft limiter to normalized float samples immediately before conversion to 16-bit PCM. The EffectWidget base class documents guardFloatSampleForInt16Pcm() and softLimitFloatSampleForInt16Pcm() for any new real-time code that writes to 16-bit audio.
Each track row includes a compact mixer strip:
Options → Track Configuration also offers Clip trim (non-destructive): Trim start and Trim end skip that many seconds from the beginning and end of the clip for playback, mix, and export without deleting the underlying recording.
MIDI tracks can carry control change (CC) automation stored in the project and in exported .mid files; offline playback and mix use these events when rendering MIDI to audio.
Edit → Undo / Redo (standard shortcuts) apply to mixer and trim changes made on tracks.
Wrth ymyl arddangosfa'r amser, mae Monitro sain wrth recordio yn pennu a yw mewnbwn byw yn mynd i allbwn sain y prosiect wrth recordio:
Mae'r dewis yn cael ei gedw yn y prosiect (monitorWhileRecording yn project.json). Diffoddwch i leihau adborth meicroffon.
Wrth recordio trac newydd tra bod traciau galluogedig eraill eisoes yn cynnwys data sain neu MIDI, mae Musician's Canvas yn cyflawni recordio overdub: mae'r traciau presennol yn cael eu cymysgu gyda'i gilydd a'u chwarae'n ôl mewn amser real tra bod y trac newydd yn cael ei recordio. Mae hyn yn caniatáu i chi glywed rhannau a recordiwyd yn flaenorol wrth osod un newydd i lawr.
Mae'r cymysgedd o draciau presennol yn cael ei baratoi cyn i'r cipio ddechrau, felly mae recordio a chwarae'n ôl yn dechrau ar tua'r un eiliad, gan gadw'r holl draciau wedi'u cydamseru.
Mae Musician's Canvas yn cefnogi dau backend cipio sain:
Gellir ffurfweddu'r backend recordio fesul prosiect yn Project > Project Settings > Audio.
Mae Musician's Canvas yn recordio ar gyfradd samplu frodorol y ddyfais fewnbwn sain ac yna'n trawsnewid yn awtomatig i gyfradd samplu ffurfweddig y prosiect gan ddefnyddio ailsamplu o ansawdd uchel. Mae hyn yn golygu y gallwch osod unrhyw gyfradd samplu prosiect (e.e., 44100 Hz neu 48000 Hz) waeth beth yw cyfradd frodorol y ddyfais. Mae'r trawsnewidiad yn cadw traw a hyd yn union.
Mae rhai dyfeisiau sain (e.e., meicroffonau gwe-gamera USB) yn ffisegol mono ond yn cael eu hysbysebu fel stereo gan y system weithredu. Mae Musician's Canvas yn canfod hyn yn awtomatig ac yn addasu'r cyfrif sianeli yn unol â hynny. Os yw'r prosiect wedi'i ffurfweddu ar gyfer stereo, mae'r signal mono yn cael ei ddyblygu i'r ddwy sianel.
Dangosir nodau MIDI mewn delweddiad piano roll ar y trac.
Mae Musician's Canvas yn cynnwys metronom adeiledig y gellir ei ddefnyddio yn ystod recordio i helpu i gadw amser. Cliciwch ar fotwm y metronom ar y bar botymau (o dan y bar dewislen) i agor y ddeialog gosodiadau metronom:

Mae'r ddeialog yn darparu:
Pan fydd y metronom wedi'i alluogi, mae'n dechrau ticio unwaith y bydd y recordio'n dechrau go iawn (ar ôl i'r cyfrif tuag at i lawr 3 eiliad gwblhau), ac yn stopio pan ddaw'r recordio i ben.
Cliciwch y botwm Play i gymysgu a chwarae'n ôl yr holl draciau galluogedig. Mae tooltip y botwm yn newid i ddangos a fydd yn chwarae neu'n recordio yn seiliedig ar p'un a yw trac wedi'i arfogi. Mae traciau analluogedig (heb eu ticio) yn cael eu heithrio o chwarae'n ôl.
Yn ystod chwarae'n ôl, mae traciau sain yn cael eu datgodio o'u ffeiliau FLAC ac mae traciau MIDI yn cael eu rendro i sain gan ddefnyddio'r synth FluidSynth adeiledig. Mae'r holl draciau yn cael eu cymysgu gyda'i gilydd a'u chwarae trwy ddyfais allbwn sain y system.
Cliciwch y botwm Stop i orffen chwarae'n ôl ar unrhyw adeg.
Defnyddiwch Tools > Mix tracks to file (Ctrl+M) i allforio'r holl draciau galluogedig i ffeil sain sengl. Mae deialog yn gadael i chi ddewis y llwybr allbwn a'r fformat:
Mae'r cymysgedd yn defnyddio cyfradd samplu ffurfweddig y prosiect. Mae traciau MIDI yn cael eu rendro gan ddefnyddio'r SoundFont ffurfweddig.
Defnyddiwch Settings > Configuration (Ctrl+,) i osod rhagosodiadau byd-eang sy'n berthnasol i bob prosiect:



.sf2 ar gyfer synthesis MIDI. Ar Linux, gellir canfod SoundFont system yn awtomatig os yw'r pecyn fluid-soundfont-gm wedi'i osod. Ar Windows a macOS, rhaid i chi ffurfweddu'r llwybr SoundFont â llaw.

Defnyddiwch Project > Project Settings (Ctrl+P) i orosgyn rhagosodiadau byd-eang ar gyfer y prosiect cyfredol yn unig. Mae hyn yn ddefnyddiol ar gyfer prosiectau sydd angen cyfradd samplu benodol, SoundFont, neu ddyfais sain. Mae gosodiadau penodol i'r prosiect yn cael eu cadw y tu mewn i'r ffeil project.json.


The Mix Effects tab is a scrollable list with the same controls as Track effects (Add effect…, drag ≡ to reorder, ✕ to remove). Processing order is top to bottom on the combined mix of all enabled tracks. These effects run during whole-project playback and when mixing to a single WAV or FLAC file; they are not baked into individual track files on disk. An empty list leaves the mixed signal unchanged aside from the mixer's own level handling.
Configure the shared aux effect chain (same effect types as track inserts). Each track’s Aux slider on the track row controls how much of that track’s signal is sent through this bus; the wet aux return is summed with the dry mix before Mix Effects are applied.
| Eitem Dewislen | Llwybr Byr | Disgrifiad |
|---|---|---|
| Save Project | Ctrl+S | Cadw'r prosiect cyfredol i ddisg |
| Open Project | Ctrl+O | Agor ffeil prosiect presennol |
| Close | Ctrl+Q | Cau'r cymhwysiad |
| Eitem Dewislen | Llwybr Byr | Disgrifiad |
|---|---|---|
| Project Settings | Ctrl+P | Configure project-specific settings (includes Aux / Send Bus) |
| Tempo map | Edit tempo changes (seconds vs BPM) for metronome and MIDI quantization | |
| Add Demo Data to Selected Track | Ychwanegu nodau MIDI sampl ar gyfer arddangosiad |
| Menu Item | Shortcut | Description |
|---|---|---|
| Undo | Ctrl+Z | Undo recent mixer/trim edits on tracks |
| Redo | Ctrl+Shift+Z | Redo |
| Eitem Dewislen | Llwybr Byr | Disgrifiad |
|---|---|---|
| Configuration | Ctrl+, | Agor gosodiadau byd-eang y cymhwysiad |
| Eitem Dewislen | Llwybr Byr | Disgrifiad |
|---|---|---|
| Mix tracks to file | Ctrl+M | Allforio'r holl draciau galluogedig i ffeil |
| Export stems to folder | One WAV stem per track (gain/pan/trim; no master Mix Effects) | |
| Recording options | Punch-in region for audio; loop playback for the whole project | |
| Quantize MIDI | Snap MIDI note starts to a grid (all MIDI tracks or armed track only) | |
| Add drum track | D | Trac MIDI drymiau a .mid (gweler isod) |
| Virtual MIDI Keyboard | Lansio'r cymhwysiad bysellfwrdd cydymaith |
| Eitem Dewislen | Llwybr Byr | Disgrifiad |
|---|---|---|
| Manual | Alt+M | Agor y llawlyfr PDF yn yr iaith sydd wedi’i dewis ar hyn o bryd |
| About | Dangos gwybodaeth fersiwn a’r cymhwysiad |
| Llwybr Byr | Gweithred |
|---|---|
| Ctrl+S | Cadw prosiect |
| Ctrl+Z | Undo (mixer/trim) |
| Ctrl+Shift+Z | Redo |
| Ctrl+O | Agor prosiect |
| Ctrl+M | Cymysgu traciau i ffeil |
| D | Ychwanegu trac drymiau (dewislen Tools) |
| Ctrl+P | Gosodiadau Prosiect |
| Ctrl+, | Gosodiadau / Ffurfweddiad |
| Alt+M | Open PDF manual (Help) |
| Ctrl+Q / Alt+F4 | Cau |
Tools → Add drum track (bysellfwrdd byr D) yn ychwanegu trac MIDI ar sianel 10 General MIDI (mynegai 9). Enw diofyn Drums.
Mae .mid yn cael ei ysgrifennu i'r ffolder prosiect ar unwaith: dwy fesur 4/4. Tempo:
Dolenni: Audient, MDrummer, Reddit, CS229 PDF.
Mae Virtual MIDI Keyboard yn gymhwysiad cydymaith (virtual_midi_keyboard) sy'n darparu bysellfwrdd piano ar y sgrin ar gyfer anfon nodau MIDI. Gellir ei lansio o'r ddewislen Tools > Virtual MIDI Keyboard yn y prif gymhwysiad, neu ei redeg yn annibynnol.

Mae bysellfwrdd y cyfrifiadur wedi'i fapio i allweddi piano ar draws dwy wythawdau:
Wythawdau isaf (yn dechrau ar yr wythawdau gyfredol):
| Allwedd | Nodyn |
|---|---|
| Z | C |
| S | C#/Db |
| X | D |
| D | D#/Eb |
| C | E |
| V | F |
| G | F#/Gb |
| B | G |
| H | G#/Ab |
| N | A |
| J | A#/Bb |
| M | B |
Wythawdau uchaf (un wythawdau yn uwch):
| Allwedd | Nodyn |
|---|---|
| Q | C |
| 2 | C#/Db |
| W | D |
| 3 | D#/Eb |
| E | E |
| R | F |
| 5 | F#/Gb |
| T | G |
| 6 | G#/Ab |
| Y | A |
| 7 | A#/Bb |
| U | B |
| I | C (wythawdau nesaf) |
| 9 | C#/Db |
| O | D |
| 0 | D#/Eb |
| P | E |
Mae allweddi'n goleuo'n weledol pan gânt eu gwasgu (mae allweddi gwyn yn troi'n las golau, mae allweddi du'n tywyllu).
Agorwch y ddeialog Ffurfweddiad (Settings > Configuration, Ctrl+,) i sefydlu dyfeisiau MIDI a sain:

.sf2 ar gyfer y synth adeiledig.| Llwybr Byr | Gweithred |
|---|---|
| Ctrl+, | Deialog ffurfweddiad |
| Ctrl+U | Cymorth / Gwybodaeth defnydd |
| Ctrl+Q | Cau |
.sf2) ar gyfer chwarae'n ddiweddarach.Mae'r nodau'n ymddangos yn y piano roll. Mae File > Save Project yn ysgrifennu ffeil .mid a project.json yn ffolder y prosiect.
Mae chwarae'n defnyddio FluidSynth gyda SoundFont y gosodiadau. Gwiriwch Settings > Configuration > MIDI (neu Project > Project Settings os oes diystyriadau prosiect): rhaid bod llwybr dilys .sf2. Ar Linux efallai y caiff SoundFont y system ei ganfod yn awtomatig; ar Windows a macOS yn aml mae angen dewis y ffeil â llaw.
Maen nhw'n ddwy raglen ar wahân. Lansiwch Virtual MIDI Keyboard o Tools > Virtual MIDI Keyboard (neu ar ei ben ei hun). I nodau'r bysellfwrdd ar y sgrin gyrraedd i Musician's Canvas wrth recordio MIDI, rhaid i'r OS lwybro allbwn MIDI y bysellfwrdd i fewnbwn mae Musician's Canvas yn ei ddefnyddio — yn aml trwy gebl MIDI ffug neu borthladdoedd cyfatebol yn y ddwy ap. Nid ydyn nhw'n cysylltu'n awtomatig.
Mae Settings > Configuration yn gosod rhagosodiadau cyffredinol (thema, iaith, dyfeisiau MIDI/sain, SoundFont, ac ati). Mae Project > Project Settings yn diystyru rhai ar gyfer y prosiect cyfredol yn unig ac yn cael ei gadw yn project.json. Os yw maes yn aros ar rhagosodiad y prosiect, mae gwerth cyffredinol o Configuration yn berthnasol.
Dim ond pan fo cyfeiriadur prosiect wedi'i osod ac nad yw Musician's Canvas yn chwarae na'n recordio y derbynnir ffeiliau. Mae .wav a .flac yn cael eu cefnogi; caiff estyniadau eraill eu hepgor a'u rhestru mewn dialog. Mae pob ffeil yn drac sain newydd â'r enw o enw'r ffeil heb yr estyniad.
Mae sain yn cael ei chadw yn ffolder y prosiect fel <enw'r_trac>.flac (mae nodau fel / \ : * ? " < > | yn cael eu disodli gan danlinell). Mae ffeil y prosiect yn project.json yn yr un ffolder. Caiff traciau MIDI eu cadw fel <enw'r_trac>.mid pan fyddwch yn cadw'r prosiect (gyda nodau yn project.json hefyd).
Wrth gymysgu neu chwarae, caiff MIDI ei rendro i WAV dros dro yn fewnol yn gyntaf. Os yw llwybr y prosiect yn hysbys, mae Musician's Canvas hefyd yn ysgrifennu FLAC storfa yn ffolder y prosiect: <enw_trac_glan>.flac (yr un rheolau â ffeiliau trac eraill). Mae'r enw'n seiliedig ar enw'r trac, nid ID mewnol.
Na. Dim ond un trac yn gallu bod wedi'i arfogi ar y tro; mae'n derbyn y recordiad nesaf. Adeiladwch y darn trwy recordio un ar ôl y llall (mae overdub yn chwarae traciau presennol wrth recordiad newydd).
Na. Pan fo wedi'i alluogi, caiff y metronom ei chwarae trwy sain y system fel cyfeiriad i chi yn unig. Nid yw'n cael ei gymysgu i mewn i'r ffeil recordio.
Ar Windows mae'r brif raglen yn disgwyl gyrrwr ASIO ar gyfer sain dibynadwy o oedi isel. Gosodwch ASIO4ALL neu yrrwr y gwneuthurwr os yw gwallau'n digwydd.
Yn y becyn .app, caiff y gweithredadwy Virtual MIDI Keyboard ei gopïo i mewn i Musician's Canvas.app (Contents/MacOS/) fel bod modd dosbarthu un ffolder ap. Agorwch ef o hyd o Tools > Virtual MIDI Keyboard.
amixer neu osodiadau sain eich bwrdd gwaith i wirio lefelau cyfaint..sf2) wedi'i ffurfweddu yn Settings > Configuration > MIDI.fluid-soundfont-gm wedi'i osod.libpipewire-0.3-dev wedi'i osod (sydd ei angen ar gyfer integreiddio PipeWire â'r synth FluidSynth).Gweler y README am gyfarwyddiadau adeiladu cyflawn ar gyfer Linux, macOS, a Windows, gan gynnwys yr holl ddibyniaethau gofynnol.