Repository navigation
Handleiding
In English: Manual
Zangbundel is een zangbundel voor bij het kampvuur. Eén telefoon is de kampvuurleider: die kiest de liederen en stuurt de tekst via Bluetooth naar alle telefoons in de buurt. De anderen zijn zangers: zij zien de tekst die de leider stuurt. Tijdens het kampvuur is er geen internet nodig, geen wifi en geen koppelen van Bluetooth.
De app bevat zelf geen liedteksten. Liederen komen uit bibliotheken die de leider toevoegt; elke bibliotheek heeft een eigen licentie. Om mee te zingen heb je geen bibliotheek nodig: de leider stuurt elk lied.
De app toont zijn schermen in het Nederlands, Engels of Duits. Deze handleiding hoort bij versie 0.4.0.
- Installeren
- De eerste keer
- Liederen toevoegen
- De zangbundel
- Setlists
- Een kampvuur leiden
- Meezingen
- Herinneringen
- Instellingen
- Over en privacy
- Als het niet lukt
Zangbundel is een Android-app (Android 8 of nieuwer). Installeer hem via Google Play, het liefst thuis, vóór het kamp: installeren heeft internet nodig.
Heeft iemand de app nog niet? Op Over → Zangbundel op een andere telefoon staat een QR-code met de link naar de app; met Link delen stuur je de link door. Tijdens een kampvuur vindt de leider hetzelfde in de leiderbalk onder App installeren.
Zonder internet kan de app van telefoon naar telefoon: kies op dat scherm Delen zonder internet en volg de stappen. Je deelt het installatiebestand via Quick Share of Bluetooth. Een kopie die zo is gedeeld, is echt als de vingerafdruk onder Over → Ondertekening 57:86:7B:…:9B:10 is.
Bij de eerste keer openen zie je Zo werkt het, met de knop Wat gebeurt er met mijn gegevens?. Tik op Beginnen.
Het startscherm vraagt dan om Bluetooth toestaan. Android vraagt toestemming om apparaten in de buurt te vinden; die heeft de app nodig om mee te zingen en om een kampvuur te starten. De app leest geen locatie. Op Android 11 en ouder vraagt Android wel om locatietoestemming, omdat zoeken naar Bluetooth-apparaten daar zo werkt. Staat Bluetooth uit, dan biedt de app Bluetooth aanzetten aan.
Alleen de leider heeft liederen nodig. Ga naar Zangbundel → Bibliotheken.
- Zangbundel bibliotheek toevoegen: de eigen bibliotheek van de app met kampvuur- en kinderliederen, gedownload van GitHub.
-
Bibliotheek toevoegen → Online: typ het webadres van een bibliotheek, een release-index of een
.zbl-bestand en tik op Opzoeken. De app laat de versie en grootte zien; tik op Downloaden. -
Bibliotheek toevoegen → Uit een bestand: een
.zbl- of.zip-bestand dat al op de telefoon staat, handig op een kampterrein zonder internet. Tik op Bestand openen. - Vanuit een andere app: kreeg je een bibliotheek in WhatsApp, of downloadde je er een in Chrome? Kies daar Delen en dan Zangbundel. De bibliotheek gaat dan dezelfde stappen door als bij Uit een bestand. Op het bestand zelf tikken opent Zangbundel niet: chat-apps vertellen de telefoon niet wat voor bestand het is. Signal en Gmail kunnen een bestand niet aan een andere app geven: sla het eerst op of download het, en deel het dan vanuit je bestandsbeheer (op een Samsung Mijn bestanden), of gebruik Uit een bestand.
Daarna toont de app de licentie van de bibliotheek. Pas na Accepteren komen de liederen in de zangbundel. Liederen die de app niet kan lezen, worden overgeslagen; het rapport zegt welke en waarom.
Ondertekende bibliotheken. Een bibliotheek die met de bibliotheekmanager is gemaakt, kan ondertekend zijn. In de lijst staat dan Ondertekend door, de naam van de maker en een vingerafdruk zoals 21FE-31DF-A154-A261. De naam kiest de maker zelf; de vingerafdruk is wat je kunt vergelijken. Een bibliotheek zonder ondertekening toont Niet ondertekend. Dat is gewoon voor de bibliotheken van vroeger, en ze werken precies hetzelfde. Zo'n bibliotheek wordt in zijn geheel geweigerd als er ook maar iets mis mee is; het rapport zegt dan welk bestand.
Een vraag bij het toevoegen. Een nieuwere versie van een bibliotheek die je al hebt, werkt de app gewoon bij. De app vraagt het eerst als de nieuwe:
- dezelfde of een oudere versie is;
- door iemand anders is ondertekend dan je vorige versie, of niet is ondertekend terwijl die van jou dat wel was;
- dezelfde naam heeft als een andere bibliotheek die je al hebt: je kunt hem dan Apart toevoegen of jouw bibliotheek Vervangen.
Twijfel je, tik dan op Annuleren: er verandert niets.
Per bibliotheek kun je:
- de liederen Aan of Uit zetten in de zangbundel;
- Bijwerken naar de nieuwste versie; de app laat zien wat er veranderd is. Een bibliotheek die je als bestand kreeg, heeft geen Bijwerken: open het nieuwere bestand van de maker op dezelfde manier. Wat de maker over die versie schreef, staat dan onder de bibliotheek;
- op Licentie tikken om de licentie nog eens te lezen;
- Automatisch controleren op wifi aanzetten: één keer per dag, alleen op wifi, en er wordt niets gedownload tot je op Bijwerken tikt;
- Verwijderen.
Weigert de app een bibliotheek met Deze bibliotheek vraagt een nieuwere versie van de app, werk dan de app bij.
Zangbundel op het startscherm toont alle liederen van de bibliotheken die aan staan.
- Zoeken zoekt op titel; met Ook in de tekst ook in de liedteksten.
- De knoppen onder het zoekveld filteren, bijvoorbeeld op taal of soort lied; A–Z wisselt de volgorde.
- Tik op een lied om het te lezen.
- Vegen gaat naar het volgende of vorige lied: naar links het volgende, naar rechts het vorige, in de volgorde van de lijst zoals je hem zag (met je zoekwoord, filters en volgorde). Bij het eerste en laatste lied houdt het op.
- Onderaan staan drie ronde knoppen: ‹ vorig lied, ⓘ liedinfo (tekst en muziek, licentie, bron) en › volgend lied. Ze worden lichter als je ze een paar seconden niet gebruikt; aanraken haalt ze terug. Lang drukken op de titel toont ook de liedinfo.
- Een lied dat je uit een herinnering opent, is één los lied: daar veeg je niet.
- Vanuit een lied voeg je het toe aan een setlist.
Een setlist is de lijst liederen voor een avond. Ga naar Zangbundel → Setlists.
- Nieuwe setlist maakt een lege lijst; vul hem vanuit de zangbundel met Toevoegen aan setlist….
- Sleep een lied aan het handvat om de volgorde te veranderen.
- Naam wijzigen, Dupliceren en Verwijderen werken op de hele lijst; de liederen blijven in de zangbundel.
-
Exporteren deelt de setlist als
.zbs-bestand; Importeren leest zo'n bestand of het webadres ervan. - Uit bibliotheken toont setlists die in een bibliotheek zitten; die zijn alleen te lezen.
Staat een lied van de setlist niet in je bibliotheken, dan staat het als niet gevonden in de lijst; het vult zich aan zodra de bibliotheek is toegevoegd.
Zet de batterijbespaarstand uit en neem een powerbank mee: een kampvuur duurt uren, en de bespaarstand kan het uitzenden stoppen. Het startscherm herinnert je daaraan.
- Tik op het startscherm op Kampvuur leiden. De app luistert eerst 5 seconden (Even luisteren…) of er al een kampvuur in de buurt is. Is dat zo, dan zegt de app Er brandt al een kampvuur: zing daar mee, of ga buiten bereik.
- Kies op Kampvuur starten:
- Naam van het kampvuur (voorgesteld: Kampvuur met de datum);
-
Wie mag meedoen:
- Iedereen in de buurt: zangers tikken op het kampvuur in hun lijst;
- Met een deelnamecode: vier cijfers die je hardop zegt;
- Alleen via de QR-code: zangers scannen de QR-code van je scherm; zo komt niemand anders binnen. Aan te raden voor jonge groepen;
- Setlist, of Geen setlist.
- Tik op Starten. De eerste keer legt de app uit dat er een melding komt zolang het kampvuur loopt, en vraagt Android of dat mag. Weigeren mag: het kampvuur werkt dan precies hetzelfde.
Je ziet dezelfde tekst als de zangers. Bovenaan staat de setlist; elk lied begint met een balk met Nu.
- Nu stuurt dat lied naar alle zangers. Het lied krijgt een oranje streep en wordt gezongen; eerdere liederen staan als gezongen.
- Wis op het lied dat gezongen wordt: er wordt even niets gezongen. Zangers houden de tekst, met gewist in hun balk.
- Zonder setlist zie je Kies een lied uit de zangbundel met Zangbundel openen.
- De ronde knoppen rechtsonder (▲ vorig lied, ≡ lijst, ▼ volgend lied) bewegen alleen jouw eigen scherm; ze sturen niets.
≡ opent het blad met twee tabbladen:
- Setlist: het lied dat gezongen wordt en de gezongen liederen blijven staan; de volgende liederen verplaats je aan hun handvat of veeg je weg (even Ongedaan maken). Elke wijziging gaat meteen naar de zangers.
- Zangbundel: zoek op titel. Toevoegen zet het lied achteraan de setlist; Nu zingen zet het direct na het huidige lied en stuurt het meteen.
De smalle balk bovenaan toont de naam, de twee woorden, het aantal zangers en de tijd. Tik erop (of trek hem omlaag) om hem te openen:
- Tijd, Liederen, Aangemeld (met het hoogste aantal) en Bereik (goed, matig of zwak);
- De twee woorden van dit kampvuur: groot, om hardop te zeggen. Zangers zien dezelfde woorden naast de naam van het kampvuur; een telefoon die in een andere taal staat, toont ze vertaald (kalf-harp wordt calf-harp);
- Deelnamecode (als je die koos) en QR-code tonen: de QR-code groot op een wit vlak; tik om te sluiten;
- App installeren: de link naar de app voor wie hem nog niet heeft;
- Statistieken delen, als je statistieken bewaart (zie Instellingen);
- een ⚠ in de balk als de batterijbespaarstand aan staat of er een ander kampvuur in de buurt is; de geopende balk zegt welke;
- Kampvuur beëindigen.
Kampvuur beëindigen → Afsluiten: de zangers zien dat het kampvuur is afgelopen en de liedteksten verdwijnen van hun telefoons. Jij ziet een overzicht (tijd, liederen, meeste zangers tegelijk) en tikt op Terug naar start.
Stopt de app terwijl je leidt, open hem dan binnen 10 minuten opnieuw: je krijgt Hervatten (verder met dezelfde zangers en liederen) of Opnieuw beginnen.
- Uit de lijst: open de app. Onder Kampvuren in de buurt staat elk kampvuur met zijn twee woorden en hoe dichtbij het is (Dichtbij, Binnen bereik, Ver weg). Tik erop. Staat er een slotje, typ dan de deelnamecode die de leider zegt.
- Met de QR-code: scan de QR-code op het scherm van de leider met je camera-app. Zangbundel opent en zoekt het kampvuur (Kampvuur zoeken…, Gevonden, controleren…). Heb je de app nog niet, dan opent een webpagina die naar Google Play leidt.
Zie je twee kampvuren met bijna dezelfde naam? Vraag de leider naar de twee woorden. Staat jouw telefoon in een andere taal dan die van de leider, dan zie je dezelfde woorden vertaald.
De smalle balk bovenaan toont de naam van het kampvuur, de twee woorden en of je verbonden bent.
- Tik op de twee woorden om te lezen wat ze betekenen.
- Tik op de balk voor de werkbalk: Dag/Nacht, Kleiner/Groter, Passend (de tekst past in de breedte), Liedinfo, de helderheid, Scherm blijft aan en Leider volgen.
- Scrollen: sleep, of tik in de onderste helft (een regel verder) of de bovenste helft (een regel terug).
- Leider volgen staat aan als je meedoet: bij elk nieuw lied springt je scherm naar het begin. Scroll je zelf, dan pauzeert het; het volgende lied van de leider zet het weer aan.
- De ronde knoppen: ▲ vorig lied, ≡ de liedjeslijst, ▼ volgend lied. In de lijst kun je ook in je eigen Zangbundel bladeren; Terug naar het huidige lied brengt je terug.
Druk op terug (of kies Kampvuur verlaten onderaan de lijst) en bevestig met Verlaten. Als de leider het kampvuur beëindigt, wordt de balk oranje: tik erop om te verlaten. De liedteksten van de leider worden daarna van je telefoon gewist; de lijst met gezongen liederen blijft als herinnering.
Herinneringen op het startscherm toont na elk kampvuur de lijst met gezongen liederen, als leider en als zanger. Met Deel de lijst deel je hem; Verwijderen en Alles verwijderen wissen ze. Je bibliotheken blijven.
- Taal: Automatisch volgt de taal van de telefoon; of kies Nederlands, English of Deutsch. Staat de telefoon in een taal die de app niet heeft, dan toont de app Engels. Op Android 13 en nieuwer kan het ook in de instellingen van de telefoon, bij de app.
- Je naam: niet verplicht; alleen je voornaam of bijnaam. Alleen de leider kan hem lezen; zonder naam ben je een zanger met een nummer. Tik op het vinkje of op Klaar op het toetsenbord als je klaar bent; Opgeslagen. bevestigt het. Ook als je het scherm gewoon verlaat, blijft de naam bewaard.
- Statistieken van kampvuren (voor leiders, standaard uit): de telefoon bewaart per kampvuur zonder namen welke liederen er gestuurd werden, hoeveel zangers er waren en hoe goed Bluetooth hen bereikte. Het scherm zegt precies wat wel en niet. Er wordt niets verstuurd; het gaat alleen van je telefoon af als je zelf op Delen tikt.
- Alle gegevens verwijderen: bibliotheken, setlists, herinneringen en instellingen gaan van de telefoon; de app begint opnieuw zoals op de eerste dag.
Over toont de versie van de app, de geïnstalleerde bibliotheken, de Ondertekening (de vingerafdruk van de echte app), een link naar de broncode en deze handleiding.
Zoeken naar een nieuwe versie vraagt GitHub welke versie van de app de nieuwste is. Dat gebeurt alleen als je erop tikt, en er is internet voor nodig. Is er een nieuwere, dan opent een knop Google Play, F-Droid of de downloadpagina: waar je de app ook vandaan hebt. Tijdens een kampvuur kan het niet.
In het kort over je gegevens: de app stuurt alleen tijdens een kampvuur iets, via Bluetooth naar telefoons in de buurt: het kampvuur en de liedteksten. Een naam kan alleen de leider lezen. Er gaat niets naar de makers van de app: geen account, geen reclame, geen volgen. Internet gebruikt de app alleen om een bibliotheek of setlist te downloaden die jij kiest, en om naar een nieuwe versie te zoeken als je daarop tikt. De volledige uitleg staat in de app onder Wat gebeurt er met mijn gegevens? en in de privacyverklaring.
| Wat je ziet | Wat je kunt doen |
|---|---|
| Geen kampvuren in de lijst | Staat Bluetooth aan en is het toegestaan? Ga dichter bij de leider staan. Of scan de QR-code van de leider. |
| Ga dichter bij de kampvuurleider staan | De QR-code is goed, maar het kampvuur is nog niet gehoord. Loop naar de leider en tik op Opnieuw zoeken. |
| Dit is niet het kampvuur van de QR-code | Een ander kampvuur doet zich voor als dat van de QR-code. De app gaat er niet in. Ga naar start en vertel het de leider. |
| De leider heeft de code niet aangenomen | Vraag de deelnamecode nog eens, of scan de QR-code. |
| Er brandt al een kampvuur | Je kunt niet starten naast een ander kampvuur: zing daar mee, of ga buiten bereik. |
| Laad eerst liederen | Een leider heeft een bibliotheek nodig; zie Liederen toevoegen. |
| Zangers raken de verbinding kwijt | Zet bij de leider de batterijbespaarstand uit en houd de telefoon in het midden van de groep. |
| Deze bibliotheek vraagt een nieuwere versie van de app | Werk de app bij via Google Play. |
| Op een bibliotheek tikken in WhatsApp, Gmail of Chrome opent Zangbundel niet | Gebruik Delen → Zangbundel, of sla het bestand op en kies Bibliotheek toevoegen → Uit een bestand. |
| Bestanden voor oudere Zangbundel-apps ontbreken, … past niet bij de bibliotheek of De ondertekening van de bibliotheek klopt niet | Het bestand is veranderd of beschadigd nadat het gemaakt is. Vraag de maker om het opnieuw op te slaan in de bibliotheekmanager, en stuur het opnieuw. |
Vragen of fouten? Meld ze op GitHub.