LOOP·MARK Player v4

📖 LOOP·MARK Handbuch

Willkommen bei LOOP·MARK

LOOP·MARK ist ein browserbasierter Media-Player für Musiker, Lehrer und Lernende. Er ermöglicht präzise Marker-Steuerung, professionelle Loop-Funktionen und — als Kernfunktion — eine Tonhöhen-Verschiebung in Halbtönen bei konstanter Wiedergabegeschwindigkeit.

1. Medium laden

Methode	Beschreibung
📁 Datei laden	Lokale Audio- oder Videodatei öffnen (MP3, WAV, OGG, FLAC, MP4, M4A, WebM …)
Audio-URL	Direktlink zu einer Audiodatei im Internet eingeben und abspielen
YouTube	YouTube-URL einfügen (z.B. https://youtu.be/XXXX). Hinweis: Pitch-Shift ist bei YouTube nicht verfügbar.
HLS / DASH / Icecast	Live-Streams und Internet-Radio direkt abspielen

2. Wiedergabe-Steuerung

Button / Taste	Funktion
▶ / ⏸ / Leertaste	Play / Pause umschalten
■ Stop	Stoppt und springt zum Anfang
«5 / 5» / ← →	5 Sekunden zurück / vor
«10 / 10»	10 Sekunden zurück / vor
Shift+←/→	1 Sekunde zurück / vor
⏮ / ⏭ / , .	Zum vorherigen / nächsten Marker springen
Timeline-Klick	Direkt zu einer Position springen
🔊 Lautstärke	Wiedergabelautstärke einstellen

2b. Geschwindigkeit

Die Buttons 0.25× bis 2× ändern die Wiedergabegeschwindigkeit auf native Weise — die Tonhöhe verschiebt sich dabei proportional mit (langsamer = tiefer, schneller = höher). Nützlich für schnelles Durchhören oder Zeitlupen-Effekte. Unabhängig vom Pitch-Shift — beide Funktionen lassen sich kombinieren.

3. Pitch-Shift — Tonhöhe in Halbtönen Kernfunktion

Die Tonhöhe kann in Halbtönen von −12 bis +12 verschoben werden — die Wiedergabegeschwindigkeit bleibt dabei immer konstant. Ein Lied in C-Dur bleibt im selben Tempo, klingt nach +3 Halbtönen aber in Eb-Dur.

Anwendungsbeispiele

Transponieren: Lied für ein anderes Instrument oder eine andere Stimmlage anpassen.
Stimmung angleichen: Aufnahme auf 440 Hz bringen ohne Tempoänderung.
Übungshilfe: Schwierige Passagen in einer anderen Tonart üben.
+12 / −12: Eine ganze Oktave höher oder tiefer transponieren.

Element	Beschreibung
Pitch-Schieberegler	Stufenweise Verschiebung von −12 bis +12 Halbtönen
Preset-Buttons	Schnellzugriff auf musikalisch sinnvolle Intervalle (Halbton, Ganzton, Terz, Quarte, Quinte, Oktave)
0 (grüner Button)	Sofortige Rückkehr zur Original-Tonhöhe
Status-Anzeige	Zeigt ob Pitch-Shift aktiv verarbeitet oder bereit ist

Technik: Der Player verwendet OLA-Time-Stretching (Overlap-Add) mit der Web Audio API. Das Audio wird mit einer kombinierten Rate (1,0 × Pitch-Ratio) gestreckt und mit der Pitch-Ratio als Abspielrate wiedergegeben — so entsteht reines Pitch-Shifting ohne Tempoänderung. Nur für lokale Dateien und direkte URLs verfügbar. Bei YouTube aus technischen Gründen nicht möglich.

4. Marker setzen und bearbeiten

Marker sind Zeitmarkierungen auf der Timeline, die als Sprungpunkte oder Loop-Grenzen dienen.

Aktion	Beschreibung
+ Marker / M	Marker an der aktuellen Wiedergabeposition setzen
Pin ziehen	Marker-Pin auf der Timeline mit der Maus verschieben
Zeit-Eingabe	Im Listenfeld die Zeit direkt editieren (Format: 1:23 oder 83.5)
Name editieren	Den Marker-Namen direkt in der Liste ändern
✏ Bearbeiten	Öffnet ein Fenster für Name, Zeit und Farbe
▶ Springen	Springt zur Marker-Position
✕ Löschen	Entfernt den Marker

5. Loop-Funktionen

Auto-Loop (⟳) — Taste A

Sobald sich die Wiedergabe zwischen zwei Markern befindet, wird der Bereich gelb auf der Timeline markiert. Der Auto-Loop-Button (oder Taste A) aktiviert dann den Loop genau für diesen Bereich — automatisch, ohne manuelles A/B setzen.

Manueller Loop A→B — Taste L

In der Marker-Liste jeden Marker als A (Start) oder B (Ende) definieren. Der Loop A→B-Button (oder Taste L) aktiviert dann den Loop zwischen diesen Punkten. Manueller Loop hat Vorrang vor Auto-Loop.

Element	Bedeutung
Blaue Zone	Aktiver manueller Loop A→B
Gelbe gestrichelte Zone	Erkannter Auto-Loop-Bereich (zwischen umgebenden Markern)
Badge	Zeigt den aktiven Loop an (Name der Marker)

6. Projekt speichern und laden

Mit ⬇ JSON werden alle Marker, Loop-Einstellungen, Pitch und Projektname als loopmark_<name>.json gespeichert. Mit ⬆ JSON laden wird ein Projekt wiederhergestellt — alle Marker sind sofort aktiv und nutzbar. Das Medium selbst wird nicht gespeichert.

Mit 📦 ZIP Export wird ein komplettes Paket mit Player, Projektdaten und Startskripten für Windows, Mac und Linux erstellt — für die offline Nutzung.

8. Aufnahme NEU

Direkt im Player aufnehmen — ohne externe Software. Klicke Aufnahme starten und wähle vorher die Quelle:

Quelle	Beschreibung
🖥 Systemton	Nimmt den Ton auf, der vom Computer ausgegeben wird (Musik, Video, Browser-Audio). Beim Dialog „Audio freigeben" anhaken!
🎙 Mikrofon	Nimmt das Mikrofon auf. Alle angeschlossenen Eingabegeräte werden angezeigt (Headset, USB-Mikrofon, Interface …)

Aufnahme-Ablauf

1. Quelle in der Liste wählen → 2. Aufnahme starten klicken → 3. Mikrofon-/Bildschirm-Berechtigung erteilen → 4. ⏹ Stopp klicken → Aufnahme erscheint als Download-Link und kann sofort direkt in den Player geladen werden.

Systemton (Loopback) — Besonderheiten je System

System	Hinweis
Windows	Chrome/Edge: im Freigabe-Dialog Tab oder Fenster wählen und „Audio freigeben" anhaken. Für vollständigen Systemton: „Gesamter Bildschirm" + Audio.
macOS	Safari/Chrome: Tab-Audio funktioniert direkt. Echter Systemton (alle Apps) erfordert einen virtuellen Audio-Treiber (z.B. BlackHole oder Loopback) und dann als Mikrofon-Eingang wählen.
Linux	PulseAudio/PipeWire: Monitor-Gerät (z.B. „Monitor of Built-in Audio") als Mikrofon auswählen. In PipeWire mit pw-loopback oder pavucontrol konfigurieren.
Android	Chrome 74+: Tab-Audio über Bildschirmfreigabe aufnehmbar. Vollständiger Systemton je nach Hersteller.
iOS / iPadOS	Systemton-Aufnahme über Browser technisch nicht möglich (iOS-Einschränkung). Mikrofon-Aufnahme funktioniert in Safari.

Format: Aufnahmen werden intern als WebM/Opus aufgezeichnet und danach automatisch zu MP3 (128 kbps, 44,1 kHz) konvertiert — universell kompatibel mit allen Geräten und Programmen. Die Konvertierung läuft vollständig im Browser, ohne Upload. Bei sehr langen Aufnahmen (>30 min) kann die Konvertierung einige Sekunden dauern. Mehrere Aufnahmen bleiben bis zum Schließen der Seite erhalten.

9. Tastatur-Übersicht

Taste	Funktion
Leertaste	Play / Pause
← / →	±5 Sekunden
Shift+←/→	±1 Sekunde
M	Marker setzen
L	Loop A→B ein/ausschalten
A	Auto-Loop ein/ausschalten
,	Zum vorherigen Marker
.	Zum nächsten Marker
Esc	Fenster schließen

Welcome to LOOP·MARK

LOOP·MARK is a browser-based media player for musicians, teachers, and learners. It offers precise marker control, professional loop functions, and — as its key feature — pitch shifting in semitones at constant playback speed.

1. Loading Media

Method	Description
📁 Load File	Open a local audio or video file (MP3, WAV, OGG, FLAC, MP4, M4A, WebM …)
Audio URL	Enter a direct link to an audio file on the internet
YouTube	Paste a YouTube URL (e.g. https://youtu.be/XXXX). Note: pitch shift is not available for YouTube.
HLS / DASH / Icecast	Play live streams and internet radio directly

2. Playback Controls

Button / Key	Function
▶ / ⏸ / Space	Toggle Play / Pause
■ Stop	Stop and return to beginning
«5 / 5» / ← →	Skip 5 seconds backward / forward
«10 / 10»	Skip 10 seconds backward / forward
Shift+←/→	Step 1 second backward / forward
⏮ / ⏭ / , .	Jump to previous / next marker
Timeline click	Jump directly to any position
🔊 Volume	Adjust playback volume

2b. Playback Speed

The 0.25× to 2× buttons change playback speed natively — pitch shifts proportionally (slower = lower, faster = higher). Useful for quick skimming or slow-motion effects. Independent of pitch shift — both can be combined.

3. Pitch Shift — Semitones at Constant Speed Key Feature

The pitch can be shifted from −12 to +12 semitones — the playback speed always stays constant. A song in C major remains at the same tempo but sounds in Eb major at +3 semitones.

Use Cases

Transposing: Adapt a song for a different instrument or vocal range.
Tuning: Match a recording to 440 Hz without changing the tempo.
Practice aid: Practise difficult passages in a different key.
+12 / −12: Transpose an entire octave up or down.

Element	Description
Pitch slider	Step-by-step shift from −12 to +12 semitones
Preset buttons	Quick access to musically useful intervals (semitone, whole tone, third, fourth, fifth, octave)
0 (green button)	Instantly return to original pitch
Status display	Shows whether pitch shift is actively processing or ready

Technology: The player uses OLA Time-Stretching (Overlap-Add) with the Web Audio API. Audio is stretched at a combined rate (1.0 × pitch ratio) and played back at the pitch ratio speed — producing pure pitch shifting without tempo change. Available for local files and direct URLs only. Not available for YouTube due to technical limitations.

4. Setting and Editing Markers

Markers are timestamps on the timeline that serve as jump points or loop boundaries.

Action	Description
+ Marker / M	Place a marker at the current playback position
Drag pin	Drag a marker pin on the timeline with the mouse
Time input	Edit the time directly in the list field (format: 1:23 or 83.5)
Edit name	Change the marker name directly in the list
✏ Edit	Opens a dialog for name, time, and color
▶ Jump	Jump to the marker position
✕ Delete	Remove the marker

5. Loop Functions

Auto-Loop (⟳) — Key A

Whenever playback is between two markers, that region is highlighted in yellow. The Auto-Loop button (or key A) activates looping for exactly that region — automatically, without manually setting A/B points.

Manual Loop A→B — Key L

In the marker list, designate any marker as A (start) or B (end). The Loop A→B button (or key L) then loops between those two points. Manual loop takes priority over auto-loop.

Element	Meaning
Blue zone	Active manual A→B loop
Yellow dashed zone	Detected auto-loop region (between surrounding markers)
Badge	Shows the active loop (marker names)

6. Saving and Loading Projects

Use ⬇ JSON to save all markers, loop settings, pitch, and project name as loopmark_<name>.json. Use ⬆ Load JSON to restore a project — all markers are immediately active and usable. The media file itself is not saved.

Use 📦 ZIP Export to create a complete offline package with the player, project data, and launch scripts for Windows, Mac, and Linux.

8. Recording NEW

Record directly in the player — no external software needed. Click Start Recording after selecting a source:

Source	Description
🖥 System Audio	Records audio output from your computer (music, video, browser). In the browser dialog, check "Share audio"!
🎙 Microphone	Records the microphone input. All connected audio input devices are listed (headset, USB mic, audio interface …)

Recording Workflow

1. Select source → 2. Click Start Recording → 3. Grant microphone/screen permission → 4. Click ⏹ Stop → Recording appears as a download link and can be loaded directly into the player.

System Audio (Loopback) — Per-Platform Notes

System	Note
Windows	Chrome/Edge: in the share dialog, select a tab or window and check "Share audio". For full system audio: "Entire screen" + audio.
macOS	Safari/Chrome: tab audio works directly. Full system audio (all apps) requires a virtual driver (e.g. BlackHole or Loopback), then select it as a microphone input.
Linux	PulseAudio/PipeWire: select the monitor device (e.g. "Monitor of Built-in Audio") as microphone. Configure via pw-loopback or pavucontrol.
Android	Chrome 74+: tab audio recordable via screen share. Full system audio depends on manufacturer.
iOS / iPadOS	System audio capture not possible via browser (iOS restriction). Microphone recording works in Safari.

Format: Recordings are captured internally as WebM/Opus and automatically converted to MP3 (128 kbps, 44.1 kHz) — universally compatible with all devices and software. Conversion runs entirely in the browser with no upload. For very long recordings (>30 min) conversion may take a few seconds. Multiple recordings persist until the page is closed.

9. Keyboard Shortcuts

Key	Function
Space	Play / Pause
← / →	±5 seconds
Shift+←/→	±1 second
M	Set marker
L	Toggle Loop A→B
A	Toggle Auto-Loop
,	Previous marker
.	Next marker
Esc	Close dialog