OpenQR

OpenQR

Ücretsiz, açık kaynaklı, filigransız QR kod üreticisi. Tamamen tarayıcınızda çalışır — takip yok, kayıt yok, sınır yok.

Çoğu çevrimiçi QR kod üreticisi sizi "ücretsiz" diye kandırır ve sonra filigran ekler, indirme boyutunuzu sınırlar, vektör dışa aktarmayı ödeme duvarının arkasına saklar veya kodunuzu kendi sunucuları üzerinden yönlendirir, böylece ödemeyi bıraktığınızda kodunuz ölür. QR kodu, üretilmesi hiçbir maliyet gerektirmeyen açık bir standarttır (ISO/IEC 18004). OpenQR bunu böyle korur.

Bu depo, temel üretici aracıdır — referans açık kaynaklı uygulama. Kasıtlı olarak küçük ve çatallanması kolaydır.

OpenQR sizin için yararlıysa, depoya bir yıldız bırakmanız diğer insanların onu bulmasına yardımcı olur. Tek isteğimiz budur.

Barındırılan sürüm: ücretsiz API, MCP sunucusu ve düzenlenebilir kodlar

Bu depodaki her şey ücretsizdir ve öyle kalır, filigran ve süre sınırı yoktur. openqr.uk adresindeki barındırılan sürüm, düzenlenebilir kodlar ve otomasyon isteyen kişiler için isteğe bağlı bir hesap katmanı ekler:

• Dinamik / düzenlenebilir QR kodları tarama analitiğiyle birlikte. Yazdırdıktan sonra hedefi değiştirin. Ücretsiz hesapta 1 ücretsiz (ülkeye göre 7 günlük tarama); Pro'da ayda £9 veya yılda £90 karşılığında 25 düzenlenebilir kod, bu ayrıca 90 günlük tarama analitiği penceresinin yanı sıra şehir ve bölge detayı, cihaz ve yönlendiren kaynak dökümleri, CSV dışa aktarma, markalı alt alan adı ve parola korumalı kodlar sunar. Mevcut aboneler mevcut planlarını ve fiyatlarını korur.
• Ücretsiz REST API. Kodları programatik olarak oluşturun ve dinamik kodları yönetin. OpenAPI şeması /openapi.json adresinde; etkileşimli dokümanlar openqr.uk/api adresinde.
• Barındırılan MCP sunucusu https://openqr.uk/mcp adresinde (Streamable HTTP). QR kodlarını doğrudan Claude, Cursor veya herhangi bir MCP istemcisinden oluşturun ve yönetin. Resmi MCP Kayıt Defteri içinde listelenmiştir. Uzaktan erişim destekli istemciler bu URL'ye doğrudan bağlanır; yalnızca stdio destekli istemciler npx -y @open-qr/mcp ve OPENQR_API_KEY ayarlarıyla bu sunucuya köprü kurabilir (ayrıntılar).

Bu depodaki statik üretici bunların hiçbirini asla çağırmaz. %100 istemci tarafında kalır (Gizlilik bölümüne bakın) ve üreticiyi kullanmak veya kendi kendine barındırmak için bunların hiçbiri gerekli değildir.

MCP istemcisi bağlama

openqr.uk/api adresinden ücretsiz bir anahtar alın ve istemcinizi anahtarı bir kimlik doğrulama başlığı olarak kullanarak sunucuya yönlendirin.

Claude Code:

claude mcp add --transport http openqr https://openqr.uk/mcp \
  --header "Authorization: Bearer oqr_YOUR_KEY"

Cursor (~/.cursor/mcp.json) ve Streamable HTTP konuşan diğer tüm istemciler:

{
  "mcpServers": {
    "openqr": {
      "url": "https://openqr.uk/mcp",
      "headers": {
        "Authorization": "Bearer oqr_YOUR_KEY"
      }
    }
  }
}

Araçlar

https://openqr.uk/mcp adresindeki barındırılan MCP sunucusu şu araçları sunar (canlı set için tools/list çalıştırın). Her araç ücretsiz bir API anahtarı gerektirir — openqr.uk/api adresinden bir tane oluşturun ve MCP bağlantısında Authorization: Bearer oqr_... olarak iletin.

Araç	Ne yapar
generate_qr	Herhangi bir metin veya URL'den statik bir QR kodu oluşturur. PNG görüntüsü veya SVG işaretlemesi döndürür.
create_dynamic_qr	Hedefini daha sonra yeniden yazdırmadan değiştirebileceğiniz düzenlenebilir bir QR kodu oluşturur.
update_dynamic_qr	Dinamik bir kodun hedefini, etiketini, özel kısa bağlantısını, etiketlerini veya klasörünü değiştirir.
get_dynamic_qr	Bir kodun tüm ayrıntılarını alır: hedef, kısa bağlantı, etiket, tür, etiketler, klasör, durum, oluşturma tarihi.
get_scans	Dinamik bir kod için tarama istatistikleri.
list_dynamic_qr	Dinamik kodlarınızı kimlik, kısa URL, hedef, etiket ve durumla listeler.
delete_dynamic_qr	Dinamik bir kodu kalıcı olarak siler. Kısa bağlantısı çalışmayı durdurur.
bulk_create_dynamic_qr	Aynı anda 200'e kadar dinamik kod oluşturur.
list_folders	Klasörlerinizi listeler.
create_folder	Kodları düzenlemek için bir klasör oluşturur.
delete_folder	Bir klasörü siler. Kodları silinmez, yalnızca klasörden çıkarılır.
list_themes	Kayıtlı stil temalarını listeler. Kimliğini veya adını theme olarak ileterek birini uygulayın.
create_theme	Yeniden kullanılabilir bir stil teması kaydeder (renkler, nokta ve köşe stilleri).
delete_theme	Kayıtlı bir temayı siler. Bu temayla zaten stillendirilmiş kodlar görünümlerini korur.
get_subdomain	Hesaptaki markalı alt alan adını ve askıya alınıp alınmadığını gösterir.
set_subdomain	Markalı alt alan adını talep eder veya değiştirir, böylece kodlar {name}.oqr.to adresinde de çözümlenir. Yalnızca Pro.
clear_subdomain	Markalı alt alan adını serbest bırakır. Kodlar düz kısa bağlantıda canlı kalır.

Ayrıca 5 kaynak ve 4 istem sunar:

• Kaynaklar, openqr://preset/classic, /teal, /high-contrast, /dots ve /classy adreslerindeki yerleşik QR stil ön ayarlarıdır. Birini okuyun ve stilini create_theme öğesine iletin.
• İstemler create_tracked_qr, bulk_qr_for_print, brand_a_qr ve qr_scan_report öğeleridir.

Özellikler

• Filigran yok, boyut sınırı yok, kayıt yok — her özellik ücretsizdir
• Tasarım gereği gizli — kodlar tamamen tarayıcınızda oluşturulur; içerik asla bir sunucuya dokunmaz
• Her yere dışa aktarın — 4096 piksele kadar PNG / WebP, ayrıca gerçek vektör SVG ve PDF
• Tam stil — renkler, gradyanlar, nokta ve köşe stilleri, logo yerleştirme, "Beni tara" çerçeveleri
• Akıllı giriş — bir bağlantı veya metin yapıştırın, tür otomatik algılanır
• Zengin yükler — URL, metin, e-posta, telefon, SMS, WhatsApp, Wi-Fi ve harita tabanlı konum seçici
• Tek tıkla kopyalama, paylaşılabilir tasarım bağlantıları, açık/koyu, duyarlı, klavyeyle erişilebilir

Hızlı başlangıç

pnpm install
pnpm dev        # http://localhost:3011

Derleme ve kendi kendine barındırma

pnpm build
pnpm start      # serves on :3011 (standalone output)

Standart bir Next.js uygulamasıdır — her yerde barındırabilirsiniz (bir VPS, bir Raspberry Pi, Cloudflare, herhangi bir ters proxy arkasında). Çalıştırmak için ortam değişkeni, veritabanı veya gizli anahtar gerektirmez. Yukarıdaki dev/start betikleri 3011 portunu kullanır; aşağıdaki Docker görüntüsü 3000 portunda hizmet verir. Her iki durumda da tek yapılandırma PORT öğesidir.

Dağıtım (Docker görüntüsü)

Her sürüm etiketinde GHCR'ye çok mimarili bir görüntü (linux/amd64, linux/arm64) yayınlanır:

docker run -d --name openqr --restart unless-stopped -p 3000:3000 ghcr.io/open-qr/openqr:latest

Veya docker-compose.yml ile:

docker compose up -d          # update later: docker compose pull && docker compose up -d

Üretimde bir sürüm etiketi sabitleyin (ghcr.io/open-qr/openqr:1.0.1); latest her sürümle birlikte hareket eder. Kapsayıcı, sağlık kontrolü olan önceden derlenmiş, kök olmayan bağımsız bir sunucudur ve görüntünün içinde LICENSE ve NOTICE taşır.

Tek tıkla dağıtımlar

Ana bilgisayar	Bağlantı	Notlar
DigitalOcean App Platform	1 tık düğmesi	.do/deploy.template.yaml okur; en küçük örnek, port 3000
Render	Blueprint düğmesi	render.yaml okur; ücretli bir örnek varsayar (Render'ın ücretsiz katmanı uyur)
Koyeb	Görüntüden dağıtır	Herhangi bir genel ghcr.io/open-qr/openqr etiketi, depo derlemesi yok

Bunlardan herhangi biriyle dağıtım, AGPL-3.0 dışında hiçbir koşul eklemez: kaynak bu repodur ve görüntü lisansı ve üçüncü taraf bildirimlerini taşır.

Gömme

<Generator/> bileşeni kendi kendine yeterlidir ve yapılandırılabilir:

import { Generator } from "@/components/generator/generator";

// Full page (default OpenQR logo header):
<Generator />

// Embedded widget, your own branding, no default header:
<Generator embedded header={<MyLogo />} />

// Inject your own post-download call-to-action:
<Generator renderSuccess={(variant) => <MySupportCluster variant={variant} />} />

Araç sıfır analitik gönderir. Anonim UI olayları istiyorsanız (ör. hangi dışa aktarma biçiminin kullanıldığı — asla QR içeriği değil), bir işleyici ekleyin:

import { setTrackHandler } from "@/lib/analytics";
setTrackHandler((action, name, category) => myAnalytics.track(category, action, name));

Gizlilik

QR oluşturma %100 tarayıcınızda gerçekleşir. Tek isteğe bağlı giden çağrılar Konum aracındadır: CARTO'dan harita döşemeleri ve OpenStreetMap'in Nominatim'i aracılığıyla adres aramaları. Başka hiçbir şey cihazdan çıkmaz.

Teknoloji yığını

Next.js 16 (App Router) · React 19 · TypeScript (strict) · Tailwind v4 · qr-code-styling · Leaflet · pnpm.

Katkıda bulunma

CONTRIBUTING.md dosyasına bakın. Basit, erişilebilir, istemci tarafı ve ücretsiz tutun — hiçbir özellik filigranı kaldırmak veya bir biçimin kilidini açmak için asla ödeme gerektirmemelidir.

Lisans

AGPL-3.0 © 2026 Sam Moreton.

OpenQR'ı AGPL-3.0 altında kullanmak, incelemek, değiştirmek, kendi kendine barındırmak ve yeniden dağıtmakta özgürsünüz. Değiştirilmiş bir sürümü ağ hizmeti olarak çalıştırırsanız, AGPL kaynağınızı aynı lisans altında kullanıma sunmanızı gerektirir. Bu kullanım durumunuza uymuyorsa, ticari lisans mevcuttur — NOTICE dosyasına bakın.