kniip/README.md

kniip

kniip is een uitgebreide annotatie-editor voor Windows. Leg iets op je scherm vast, maak het duidelijk met annotaties en deel het als afbeelding, video, GIF of link.

Download: kniip

---

kniip is een annotatie-editor die naast het Windows Knipprogramma werkt. Maak een schermafbeelding, voeg pijlen, tekst, markeringen, stappen, emoji of vervaging toe en sla het resultaat op, kopieer het of upload het. kniip kan ook schermopnames maken en die exporteren als video of GIF.

Wat kan kniip?

• Knippen tot op de pixel. Rechthoek of venster, met een vergrootglas voor precieze hoeken en een instelbare vertraging om eerst een menu of tooltip te openen.
• Aantekenen. Pijlen en lijnen die je kunt buigen, tekst, vormen, genummerde stappen, markeerstift, emoji en vervaging.
• Screencasts. Neem een deel van je scherm op en exporteer als video of GIF.
• Delen. Opslaan, kopiëren naar het klembord of uploaden en de link meteen delen.
• Geschiedenis. Vind eerdere knipsels en uploads terug, met miniaturen en zoeken.
• Jouw werkbalk. Kies een of twee werkbalken, versleep knoppen en verberg wat je niet gebruikt.
• Altijd bij. kniip meldt zelf wanneer er een nieuwe versie is en werkt zichzelf bij met een klik.

Downloaden

Versie	Installer
1.1.6	Kniip-Setup-1.1.6.exe

Oudere versies vind je bij alle releases.

Installeren

1. Download Kniip-Setup-<versie>.exe via een van de links hierboven.
2. Start de installer. Beheerdersrechten zijn niet nodig: kniip wordt per gebruiker geïnstalleerd in %LOCALAPPDATA%\Programs\Kniip.
3. Kies tijdens de installatie welke integraties je wilt:
   • kniip starten met Windows (aanbevolen): kniip draait dan op de achtergrond in het systeemvak.
   • kniip tonen in 'Openen met' voor afbeeldingen (.png, .jpg, .jpeg, .bmp, .gif), ook vanuit het Knipprogramma.
   • Snelkoppeling op het bureaublad.

Beide integraties kun je later ook in- of uitschakelen via de instellingen van kniip.

Een losse .NET-installatie is niet nodig; de installer bevat alles wat kniip nodig heeft.

Systeemeisen

• Windows 10 (versie 1809 of nieuwer) of Windows 11
• 64-bits (x64)

Verwijderen

Verwijder kniip via Instellingen > Apps > Geïnstalleerde apps. Autostart en de 'Openen met'-registratie worden daarbij ook opgeruimd.

Heb je alleen Kniip.exe gestart en geen installer gebruikt, dan staat kniip mogelijk nog bij Instellingen > Apps > Opstarten. Die regel wijst naar de map waar de exe toen stond. De schakelaar daar uitzetten verbergt kniip niet: Windows bewaart de regel en zet hem alleen op uit.

tools\remove-autostart.cmd haalt de regel weg. Dubbelklik het bestand, of voer uit:

powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\remove-autostart.ps1

Het script geldt voor de aangemelde gebruiker. Het pad van de exe maakt niet uit en het bestand hoeft er niet meer te staan. Beheerdersrechten zijn niet nodig. Elke Windows-account heeft een eigen opstartlijst, dus draai het in de account waarin kniip een keer is gestart. Blijft de vermelding daarna zichtbaar, log dan een keer uit en weer in.

Zelf bouwen

Vereisten:

• .NET 8 SDK
• Inno Setup 6 (optioneel, alleen nodig voor de installer): winget install JRSoftware.InnoSetup

Bouwen:

.\build.ps1                  # versie 1.1.6
.\build.ps1 -Version 1.2.0   # andere versie

Het script levert op:

• artifacts\publish\Kniip.exe: zelfstandige exe, draait zonder installatie
• artifacts\Kniip-<versie>.exe: dezelfde exe, met het versienummer in de naam
• artifacts\Kniip-Setup-<versie>.exe: de installer (alleen als Inno Setup 6 gevonden is)
• artifacts\KniipTest-<versie>.exe: testversie (overslaan met -SkipTest)

Testversie

De testversie draait naast de geïnstalleerde kniip en raakt die niet aan. Hij gebruikt overal KniipTest in plaats van Kniip: de autostartregel, de 'Openen met'-registratie (KniipTest.Image), de instellingenmap %APPDATA%\KniipTest en de single-instance-mutex. Bij de eerste start kopieert hij de instellingen van de gewone kniip. Zichzelf bijwerken doet hij niet, want de installer zou de gewone kniip overschrijven.

Opruimen hoeft alleen als je in de testversie autostart of 'Openen met' hebt aangezet:

.\artifacts\KniipTest-<versie>.exe --unregister
Remove-Item "$env:APPDATA\KniipTest" -Recurse   # optioneel: instellingen van de testversie

Draaien beide versies tegelijk, dan reageren ze allebei op dezelfde sneltoetsen en knipsels. Sluit de gewone kniip tijdens het testen, of kies in de testversie andere sneltoetsen.

Een nieuwe versie publiceren

1. Bouw met .\build.ps1 -Version <versie>.
2. Maak op git.hibbit.net een release met tag v<versie> en voeg artifacts\Kniip-Setup-<versie>.exe toe als bijlage.
3. Schrijf de wijzigingen in markdown in de beschrijving van de release. kniip toont die als changelog onder Instellingen > Update.
4. Vervang de versie en de link in de tabel onder Downloaden door de nieuwe versie.

Updaten vanuit kniip

Onder Instellingen > Update controleert kniip via de API van git.hibbit.net of er een nieuwere release is en toont de changelog van alle nieuwere versies. Updaten downloadt de installer, sluit kniip, installeert stil en start kniip opnieuw. De eerder gekozen integraties blijven behouden.

kniip controleert ook zelf bij het starten en daarna elke 24 uur. Is er een nieuwere versie, dan staat er een blauwe stip op de knop Instellingen in de editor en op de tab Update. Dit zet je uit met Automatisch controleren op nieuwe versies in die tab.

Voorwaarden:

• De repository rogier/kniip is publiek; kniip gebruikt geen token.
• De tag is een versienummer (v1.2.0); concepten en voorversies worden overgeslagen.
• De bijlage heet Kniip-Setup-<versie>.exe. Zonder bijlage toont kniip alleen de changelog en een link naar de releasepagina.