Mample Kurulum Kılavuzu

Mample'ı en verimli şekilde kullanabilmeniz için hazırlanan detaylı yönergeleri aşağıda bulabilirsiniz.

ℹ️

Mample Nedir?

Mample, bilgisayarınızda veya tarayıcınızda uzun süren işlemlerin bittiğini takip etmenizi sağlayan basit bir bildirim sistemidir. Amacı, ekran başında beklemenize gerek kalmadan, işlemler tamamlandığında telefonunuza tek bir yerden özelleştrilebilen bildirimler göndererek sizi haberdar etmektir.

Nasıl Çalışır?

Mample genel olarak iki farklı şekilde kullanılabilir:

🧩 1. Chrome Eklentisi

Tarayıcı üzerinden yaptığınız indirmelerde veya işlem sırası beklediğiniz web sayfalarında, bir öğenin kaybolmasını algılayarak çalışır.

💻 2. Terminal (CLI) Aracı

Bilgisayarınızın terminalinde çalışan uzun soluklu komutların veya derlemelerin sonuna eklenerek, işlem bittiğinde sizi uyarır.

🧩

Chrome Eklentisi

1. Eşleşme ve Bağlantı Yönetimi

Ana ekranda sağ alt köşede bulunan yeşil QR okuyucu butonuna basarak tarayıcınızdaki Mample eklentisinin QR kodunu okutarak veya terminal kodunuzu eklentideki yerine girererek anında bağlanın. Bağlantıyı mobil uygulamanızdaki "Bağlı Cihazlar" kısmında görebilirsiniz.

Güvenliğiniz için tüm eklenti bağlantıları 23 saat sonra otomatik olarak kesilir. İsterseniz telefonunuzdaki "Bağlantıyı Kes" ikonuna (kırık zincir) tıklayarak veya eklentinizden bağlantıyı anında manuel olarak da koparabilirsiniz.

2. Tuş Seçimi Yaparak Bildirim Alma (/mample)

Bağlantıyı kurduktan sonra, tarayıcınızda işlem yaptığınız herhangi bir sitedeyken promptunuzun sonuna "/mample" yazın. Eğer o site için daha önce bir tuş seçmediyseniz, Mample'ın "Tuş Seçim Ekranı" otomatik olarak aktifleşecektir. Burada işlem başladığında beliren ama işlem bittiğinde kaybolacak olan tuşu seçiniz (genelde bu durdurma tuşu olur). Seçtiğiniz tuş kaybolduğunda işlem bitmiş olacak ve bildirim alacaksınız. İsterseniz eklentinizdeki "Tuş Seç" butonu ile de tuş seçebilirsiniz. Tuş seçili olan web sitesinde, eklentinizdeki "Özel Tuş Seçimini Kullan" butonu ile site için özel seçtiğiniz tuş görünür olduğunda ekranınızın sağ altında çıkan, bildirim almak isteyip istemediğinizi soran pop-up'a evet derseniz seçtiğiniz tuş kaybolduğunda bildirim alacaksınız. Tuş seçtiğiniz sitelerinizi eklentideki (≡) üç çizgi tuşuna basarak görüntüleyebilir ve yönetebilirsiniz.

3. Detaylı Tuş Seçimi (ÖNEMLİ)

Mample'ın işleminizin bittiğini doğru anlayabilmesi için, seçtiğiniz öğenin işlem boyunca ekranda kalıp, işlem bitince kaybolan bir öğe olması gerekir. İşlemi temsil eden dış çerçeveyi değil, sadece içindeki asıl durumu gösteren minik nesneyi seçmelisiniz.

Örnek: Claude Üretim Ekranı

YANLIŞ

Geniş ve dış çerçeve olan yuvarlak butonu seçmek.

DOĞRU

Sadece iç kısımdaki asıl "Durdurma" işlemi olan kareyi seçmek.

4. Tuş Seçimi Yapmadan Bildirim Alma (/mamplen)

Sistemde tuş belirlenmiş popüler web sitelerinde (ChatGPT, Claude, Gemini, Perplexity, Grok, Poe, Kimi, Z-AI) hiçbir öğe seçimi yapmanıza gerek yoktur. Promptunuzun sonuna doğrudan "/mamplen" yazarak gönderirseniz, sizin için önceden seçmiş olduğumuz tuş sayesinde işleminiz bittiğinde otomatik olarak bildirim gönderilir. Eklentinizdeki " Sistem Tuşunu Kullan" butonuna basarsanız hiç ekstra tuş seçimine gerek kalmadan, sisteme kayıtlı tuş sayesinde, işleme başladığınızda aynı Özel Tuş Seçimini Kullan'daki gibi sağ altta pop-up belirecek ve onayladığınızda işlem bittiğinde anında bildirim alacaksınız.

5. Dosya İndirmelerinden Bildirim Alma

Eklentinizdeki "İndirmelerden Bildirim Al (>40MB)" seçeneği ile tarayıcınızda 40 MB'dan büyük dosyaların indirilme işlemi tamamlandığında bildirim alabilirsiniz.

💻

Terminal (CLI) Aracı

1. CLI Kurulumu ve Bağlantı

Öncelikle bilgisayarınıza Mample CLI aracını global olarak kurmanız gerekir:

> npm install -g mample

Kurulum tamamlandıktan sonra, Ana Ekrandaki Terminal Aracınızda görünen Secret Key (Gizli Anahtar) bilgisini kullanarak terminale bağlantı komutunu girin:

> mample auth mample-123456-7890

2. Bildirim Gönderme

Eğer bir komutun peşine zincirleme bağlamak istiyorsanız `&& mample` kullanabilirsiniz. Test amaçlı özel mesaj göndermek isterseniz; `mample ""` formatını kullanabilirsiniz. Mesaj kısmını boş bırakmanız durumunda ayarlar menüsündeki varsayılan (default) mesaj yollanacaktır.

> npm run build && mample> python script.py && mample "Model eğitimi tamamlandı!"

3. Bağlantıyı Koparma

Terminal ve telefon arasındaki Bağlantıyı kopartmak için mobil uygulamanızda ana ekranınızdaki bağlı cihazlar kısmını kullanabilirsiniz. Eğer bunu terminal üzerinden yapmak isterseniz aşağıdaki komutu kullanabilirsiniz:

> del ~/.mample/config.json (Windows)> rm ~/.mample/config.json (Mac/Linux)

4. Mample'ı Kaldırma (Silme)

Mample CLI aracını bilgisayarınızdan tamamen silmek isterseniz terminalinizde aşağıdaki komutu çalıştırabilirsiniz:

> npm uninstall -g mample

5. Terminal İçi Yardım

Kullanabileceğiniz tüm komutları ve detaylarını görmek için aşağıdaki yardım komutunu çalıştırabilirsiniz:

> mample --help
🧠

Yapay Zeka Asistanları

1. Bilgisayar Uygulamalarında Kullanımı

Eğer süreçlerinizde terminal komutlarını çalıştırabilen yapay zeka asistanları kullanıyorsanız (örneğin VS Code, Antigravity, GitHub Copilot, Cursor, Cline, Roo Code gibi araçlar), Mample'ı onlarla entegre edebilirsiniz. Bunun için öncelikle "Terminal (CLI) Aracı" başlığındaki "1. CLI Kurulumu ve Bağlantı" adımını tamamlamış olmalısınız.

Yapay zeka asistanından uzun sürecek bir işlem talep ettiğinizde (örneğin büyük bir kod analizi, test senaryosu çalıştırma veya dosya düzenlemeleri), asistanın işlemi bitirdiğinde sizi bilgilendirmesini sağlayabilirsiniz.

2. Nasıl Talimat Verilir?

Promptunuzun sonuna aşağıdaki talimatı eklemeniz yeterlidir:

Siz👤

...işlemi bitirdiğinde terminalden 'mample' komutunu çalıştırarak beni uyar.

Asistan işlemini bitirdiğinde terminal üzerinden "mample" komutunu çalıştırarak size bildirim gelmesini sağlayacaktır.

3. İlk Kullanımda Dikkat Edilmesi Gerekenler

Yapay zeka asistanınızdan ilk defa Mample'yi uyarmasını istediğinizde, komutun çalıştırılması için bir güvenlik/izin uyarısı çıkacaktır.

⚠️Allow running this command? (mample)
1. Yes, allow this time
2. Yes, and always allow 'mample'
3. No (tell the agent what to do instead)

Eğer kırmızıyla işaretlenmiş olan "2. Yes, and always allow 'mample'" seçeneğini seçerseniz, bu uyarı bir daha karşınıza çıkmayacaktır. Yapay zeka asistanınız bu izni hatırlayacak ve Mample'yi uyar dediğinizde size hiçbir şey sormadan direkt bildirim yollayacaktır.

4. İzin Sorularını Tamamen Kapatmak (Otonom Kullanım)

Yapay zeka asistanları (Cursor, Antigravity vb.) güvenlik gereği terminal komutları için her zaman sizden izin isterler. Bunu tamamen sessiz ve otonom hale getirmek için asistanınızın kural dosyasına (örneğin .cursorrules veya AI Rules alanına) şu kuralı yapıştırın: "When you complete a task, ALWAYS autonomously run the global 'mample' command in the terminal to notify me. Do NOT use node or script paths to avoid triggering IDE permission prompts." ya da şu iki dosyayı yapay zeka asistanınızın okuması için projenizin içine koyabilirsiniz: CLAUDE.md ve setup.md

Sık Sorulan Sorular (SSS)

Mample ücretli mi?
Mample'ın temel özelliklerini kullanmak (ayda 100 bildirime kadar) tamamen ücretsizdir. Daha yoğun kullanım ve sınırsız bildirim hakkı için mobil uygulama içinden Premium pakete geçiş yapabilirsiniz.
Bilgisayarımdaki kodları, projelerimi veya mesajlarımı okuyor mu?
Kesinlikle hayır! Mample, sadece işlemin tamamlandığına dair bir sinyal taşır. Chrome eklentisinde sadece seçtiğiniz "tuşun" ekranda olup olmadığına bakar, terminalde ise kodlarınızla ilgilenmeden sadece işlem bitişini dinler. Gizlilik en büyük önceliğimizdir.
Nasıl hesap oluşturabilirim veya giriş yapabilirim?
Mample'da hesap açmanıza gerek yoktur! Gizliliğinizi en üst düzeyde tutmak için e-posta, şifre veya telefon numarası talep etmiyoruz. Sistem, eklenti ve uygulamanızı rastgele oluşturulmuş anonim bir "Secret Key" (QR Kod) ile birleştirir.
Yeni bir telefona geçersem Premium aboneliğim kaybolur mu?
Hayır. Mample'da hesap sistemi olmasa bile, satın alımlarınız doğrudan Google Play veya App Store hesabınızla eşleşir. Aynı işletim sistemine (Android'den Android'e veya iOS'tan iOS'a) sahip yeni telefonunuzda, uygulama içindeki "Aboneliği Geri Yükle" butonuna basarak haklarınızı anında geri alabilirsiniz.
Mample ekranımı mı izliyor?
Hayır, Mample kesinlikle ekranınızı veya sekmelerinizi izlemez, video veya fotoğraf kaydı almaz. Chrome eklentisi sadece sizin "/mample" komutuyla manuel olarak seçtiğiniz ya da belirli sitelerde bizim önceden seçtiğimiz tek bir düğmenin (HTML öğesinin) ekranda görünüp görünmediğini kontrol eder. İşiniz bittiğinde bu kontrol de durur.
Mample saniyede kaç kere bildirim yollayabiliyor?
Mample, spam ve suistimali önlemek için bir bekleme süresi mekanizmasına sahiptir. Üst üste çok hızlı bildirim gönderilmesini engeller, arka arkaya tetiklenmelerde minimum 3-5 saniye bekler. Bu sayede cihazınız bildirim yağmuruna tutulmaz.
Uygulamam bağlı kalmışsa yanlışlıkla bildirim gelsin istemiyorum, ne yapmalıyım?
Yanlışlıkla bildirim alma ihtimaliniz yoktur. Web tarafında sürecin başlaması için mutlaka /mample veya /mamplen yazmanız gerekir; Bu Site İçin Seçiciyi Başlat ile tuş seçtiğinizde ise sağ altta çıkan pop-up size işlemi onaylayıp onaylamadığınızı sorar. Terminal veya yapay zeka asistanlarında ise siz komutun sonuna açıkça "mample" yazmadığınız sürece hiçbir bildirim tetiklenmez.
Tarayıcım ekranda olmasa bile bildirim alacak mıyım?
Evet! Tarayıcınız arka planda çalışıyorsa, simge durumunda küçültülmüş olsa dahi bildiriminiz telefonunuza başarıyla ulaşır. Ayrıca işlem tamamlandığında (eğer başka ekrandayken pop-up çıkmasını engeleyen bir ayar yoksa) bilgisayarınızın sağ alt köşesinde "Bildirim gönderildi" yazan mor renkli bir Mample pop-up'ı da belirecektir.
Hangi yapay zeka asistanları ile çalışır? Antigravity veya Copilot gibi uygulamalarda çalışır mı?
Terminal bağlantısı ve komut çalıştırma yetkisi olan tüm asistanlarla çalışır. VS Code, Cursor, Cline, Roo Code, Antigravity, GitHub Copilot ve daha fazlası. Yapay zeka asistanınızın bilgisayarınızın terminaline erişimi olduğu sürece Mample'ı sorunsuz bir şekilde kullanabilir ve asistanınızın işlemler bittiğinde Mample üzerinden sizi uyarmasını sağlayabilirsiniz.