Repository navigation
Releases
KUVA Vpn v1.2.4
✨ What's new
Added
-
Cancellable Swift connect: the power button now stays tappable while the Kuva Swift handshake/scan is running (it can take up to ~2 minutes) — a second tap cancels the attempt and the button is ready for the next command. Previously the button was disabled during the whole scan, so there was no way to back out.
-
Swift scan shows as connecting: the power button now turns yellow (pulsing) during the Swift scan instead of staying gray until it suddenly went green.
-
Ping values colored by quality in the free vault, search results and every My Configs row (manual + subscriptions): green up to 200 ms, yellow 200–450 ms, red above ove 450 ms, gray when untested, red when dead. The dashboard stat tiles stay white — colored numbers there would fake a meaning the data doesn't have.450 ms, gray when untested, red when dead. The dashboard stat tiles stay white — colored numbers there would fake a meaning the data doesn't have.
Fixed
-
Shadowsocks links with base64-encoded userinfo failed to import (Shadowmere-style ss://BASE64@host:port#name shares were silently dropped): the form A/B heuristic misrouted them to whole-body base64 decoding, which failed. Any link containing @ before the fragment is now parsed as form A (base64(method:password)@host:port), covering raw and encoded userinfo alike; real form B links still work.
-
Quick Settings tile went stale: the KUVA tile in the Android quick settings panel only repaints while the panel is open, so connecting or disconnecting from inside the app left it showing the old state until the panel was reopened. Every state change now requests a tile refresh.
-
RTL mirroring of mixed Persian strings in the config screens: Persian-containing texts inside LTR-locked containers rendered mirrored and dropped the infinity glyph. The bidi helper now forces an explicit RTL base direction for any string containing Persian letters.
-
Subscription expiry line could overflow: the expiry is now a single non-wrapping Text; the Persian "add config" button label was shortened to fit its third of the toolbar.
-
Color drift across screens: the neon palette is now defined once as tokens in the theme (protocol badges, snackbar states, usage bars, banner dots); screens reference the tokens instead of scattering raw hex values.
✨ قابلیتهای جدید
اضافه شد
- اتصال سوئیفت قابل لغو (Cancellable Swift connect): دکمه پاور اکنون در طول اجرای هندشیک/اسکن Kuva Swift (که ممکن است تا حدود ۲ دقیقه طول بکشد) قابل لمس باقی میماند — لمس مجدد (ضربه دوم) تلاش را لغو میکند و دکمه برای دستور بعدی آماده میشود. پیش از این، دکمه در طول کل اسکن غیرفعال بود، بنابراین هیچ راهی برای انصراف وجود نداشت.
- نمایش وضعیت «در حال اتصال» برای اسکن سوئیفت: دکمه پاور اکنون در طول اسکن Swift به رنگ زرد (چشمکزن) در میآید، به جای اینکه خاکستری بماند تا ناگهان سبز شود.
- رنگی شدن مقادیر پینگ بر اساس کیفیت: در بخش کانفیگهای رایگان، نتایج جستجو و تمام سطرهای بخش «کانفیگهای من» (دستی + اشتراکها): سبز تا ۲۰۰ میلیثانیه، زرد بین ۲۰۰ تا ۴۵۰ میلیثانیه، قرمز بالای ۴۵۰ میلیثانیه، خاکستری برای تستنشدهها، و قرمز برای موارد از کار افتاده (مرده). کاشیهای آمار داشبورد سفید باقی میمانند — اعداد رنگی در آنجا معنایی کاذب ایجاد میکنند که دادهها واقعاً ندارند.
رفع اشکال
- ایمپورت لینکهای Shadowsocks با userinfo کدشده (لینکهای به سبک Shadowmere مثل
ss://BASE64@host:port#name) بیصدا رد میشدند: تشخیص فرمت لینک آنها را به اشتباه به مسیر decode اشتباه میفرستاد. حالا هر لینکی که قبل از#علامت@داشته باشد درست تجزیه میشود؛ لینکهای قدیمی هم سر جایشان هستند. - همگام نشدن تایل Quick Settings: کاشی KUVA در پنل تنظیمات سریع اندروید فقط وقتی پنل باز است بازطراحی میشود؛ پس اتصال یا قطع از داخل اپ، حالت قدیمی را روی تایل باقی میگذاشت. اکنون هر تغییر وضعیت، تایل را تازه میکند.
- آینهشدن متنهای فارسی ترکیبی در صفحات کانفیگ: رشتههایی مثل «تعدادکانفیگ» که داخل ظرفهای چپبهراست بودند، برعکس رندر میشدند و علامت بینهایت حذف میشد. کمکی bidi حالا برای هر متن حاوی حروف فارسی، جهت راستبهچپ صریح میگذارد.
- سرریز خط انقضای اشتراک: تاریخ انقضا حالا در یک خط میماند و برچسب دکمهی «افزودن کانفیگ» کوتاهتر شد تا در نوار بالا جا شود.
- یکدستسازی رنگها: پالت نئون حالا یکبار بهصورت توکن در تم تعریف شده و همهی صفحات به همان توکنها ارجاع میدهند — دیگر رنگها بین صفحات فرق نمیکنند.
نصب
- کاربران نسخههای قبلی میتوانند مستقیم همین APK معماری دستگاهشان را نصب کنند (روی نسخهی قبلی بدون حذف اپ نصب میشود) یا از دکمهی بهروزرسانی داخل خود اپ استفاده کنند.
- گوشیهای جدید و میانرده به بالا:
arm64-v8a— گوشیهای قدیمیتر:armeabi-v7a— اطمینان ندارید:universal.
KUVA Vpn v1.2.2
✨ What's new
Added
- Double-tap to connect — one tap on a config row selects it, a double tap selects AND connects, no need to go back to the home screen (My Configs + free vault). Double-tapping the connected row disconnects. With the Kuva Swift engine, a double tap quietly switches to Xray first and connects.
- Compact header status — when the power button is scrolled out of view, a small colored dot + state text appears under the KUVA VPN title.
Fixed
- Crash on theme/language change (IllegalStateException: Must be called from main thread).
- ConcurrentModificationException during group ping in the free vault.
- A second tap on the connect button now cancels a Kuva Swift connection attempt instead of queueing another start.
- Crash reports: uncaught exceptions are saved in the app (newest 5) and attach to the bug-report zip — future reports are self-sufficient.
✨ قابلیتهای جدید
اضافه شد
- اتصال با دابلتپ — یک تپ روی کانفیگ فقط انتخابش میکند، دابلتپ انتخاب و اتصال انجام میدهد، بدون برگشتن به صفحه اصلی (کانفیگهای من + کانفیگهای رایگان). دابلتپ روی ردیف متصل، قطع میکند. با موتور کوا Swift، دابلتپ اول بیصدا به Xray سوییچ میکند و بعد وصل میشود.
- وضعیت فشرده در هدر — وقتی دکمه پاور از دید خارج شود، یک نقطه رنگی + متن وضعیت زیر عنوان KUVA VPN ظاهر میشود.
رفع اشکال
- کرش هنگام تغییر تم/زبان (IllegalStateException: Must be called from main thread).
- ConcurrentModificationException هنگام پینگ گروهی در کانفیگهای رایگان.
- تپ دوم روی دکمه اتصال، تلاش اتصال کوا Swift را لغو میکند (بهجای صف کردن استارت دوباره).
- گزارش کرش: خطاهای مدیریتنشده داخل برنامه ذخیره میشوند (۵ مورد آخر) و به زیپ گزارش خطا پیوست میشوند — گزارشهای بعدی خودکفا هستند.
KUVA Vpn v1.2.1
✨ What's new — a release full of UI polish and important engine fixes
Added
- Colored status banners at the bottom of the config screens: green for success (configs added, subscription added/updated), yellow for failures (subscription update failed) — each with a fitting icon and auto-fit width.
- Protocol ribbons on config rows: a colored side badge per protocol (VLESS blue, VMess purple, …) so configs are recognizable at a glance.
- Redesigned search in the free vault and My Configs (neon-purple field, cleaner results layout).
- Language quick-switch icons (EN/FA) in Settings.
- A spinner on the subscription refresh button while the update runs (no more double-taps).
- Adding a subscription via dialog, QR or clipboard now shows the same green "Sub added" confirmation with correct wording.
Fixed
- Psiphon on armeabi-v7a devices 🔧: the bundled Psiphon core (
libpt.so) for 32-bit ARM was replaced with a working build — Kuva Swift + Psiphon now connects on older 32-bit phones. The x86_64 core was refreshed as well. - Undo banner now actually appears after deleting a config or a subscription (both in My Configs and the free-vault screen) — a lifecycle gate kept the undo listener from ever starting.
- Free-config discovery: more reliable source fetching and fingerprint deduplication (fewer duplicates, fewer failed imports).
- Notification and live-traffic-stats stability fixes.
- General dashboard / settings UI polish and theme tweaks.
Downloads
| File | For |
|---|---|
KUVAVpn-v1.2.1-arm64-v8a.apk |
All modern phones (recommended) |
KUVAVpn-v1.2.1-armeabi-v7a.apk |
Older 32-bit phones — Psiphon fixed! |
KUVAVpn-v1.2.1-x86_64.apk |
Intel tablets / x86_64 emulators |
KUVAVpn-v1.2.1-universal.apk |
Works on any device (larger) |
Minimum Android: 8.0 (API 26). Telegram: @kuvaproject
KUVAVpn نسخهی ۱.۲.۱ — طراحی مجددUI + فیکسهای مهم موتور
اضافه شد
- بنرهای وضعیت رنگی پایین صفحههای کانفیگ: سبز برای موفقیت (افزودن کانفیگ، افزودن/بهروزرسانی اشتراک) و زرد برای خطا (شکست بهروزرسانی اشتراک) — هرکدام با آیکن مناسب و عرض خودکار بر اساس متن.
- نوار پروتکل روی ردیف کانفیگها: نشان کناری رنگی برای هر پروتکل (VLESS آبی، VMess بنفش و…) تا کانفیگها از یک نگاه قابل تشخیص باشند.
- بازطراحی جستجو در مخزن رایگان و «کانفیگهای من» (فیلد بنفش نئونی، چیدمان تمیزتر نتایج).
- آیکنهای سوییچ سریع زبان (EN/FA) در تنظیمات.
- اسپینر روی دکمهی بهروزرسانی اشتراک تا پایان آپدیت (دیگه دبلتپ ممکن نیست).
- افزودن اشتراک از دیالوگ، QR یا کلیپبورد حالا همان تأییدیهی سبز «ساب اضافه شد» را با متن درست نشان میدهد.
برطرف شد
- 🔧 سایفون روی گوشیهای armeabi-v7a (۳۲ بیتی): هستهی سایفون (
libpt.so) برای ARM سیودو بیتی با نسخهای سالم جایگزین شد — Kuva Swift + سایفون حالا روی گوشیهای قدیمی هم وصل میشود. هستهی x86_64 هم بهروز شد. - درهنگام متصل بودن با لمس سوییچ تغییر موتور هسته در چند لحظه اتصال قبلی قطع و با موتور جدید استارت میشود.
- بنر Undo حالا واقعاً ظاهر میشود بعد از حذف کانفیگ یا اشتراک (هم در «کانفیگهای من» و هم در مخزن رایگان) — یک شرط چرخهی حیات باعث شده بود شنوندهی Undo هرگز شروع نشود.
- جمعآوری کانفیگ رایگان: واکشی مطمئنتر منابع و تشخیص تکراری دقیقتر (تکرار و خطای ورود کمتر).
- فیکسهای پایداری اعلان و آمار ترافیک زنده.
- صیقل عمومی UI داشبورد و تنظیمات و اصلاحات تم.
دانلود
| فایل | برای |
|---|---|
KUVAVpn-v1.2.1-arm64-v8a.apk |
همهی گوشیهای مدرن (پیشنهادی) |
KUVAVpn-v1.2.1-armeabi-v7a.apk |
گوشیهای قدیمی ۳۲ بیتی — سایفون فیکس شد! |
KUVAVpn-v1.2.1-x86_64.apk |
تبلتهای اینتل / شبیهسازهای x86_64 |
KUVAVpn-v1.2.1-universal.apk |
هر دستگاهی (حجم بیشتر) |
حداقل اندروید: ۸.۰ (API 26). تلگرام: @kuvaproject
KUVA Vpn v1.2.0
KUVA Vpn 1.2.0
✨ What's new
Psiphon reverse-mode routing (Kuva Swift)
- New optional psiphon layer rides inside the MASQUE tunnel (WARP → Psiphon)
- 28-country exit picker with live flags: dashboard quick card + country sheet
- Reverse mode dials the whole tunnel through psiphon, so every probe already sees the true psiphon exit country
Real Swift progress bar
- Progress is now fully event-driven from the core's real log lines (identity → gateway scan → best gateway → TLS → data-plane validation → WARP on)
- Monotonic: the bar never jumps backwards or fakes a stall at 90%
- A localized stage label is shown under the bar (English + فارسی)
🛠️ Bug fix
Tunnel watchdog
- Tunnel drops (
h2 keepalive timeout,connection aborted) are detected from
core logs — the core process survives and self-reconnects, so process-death
callbacks alone never caught these - The UI honestly shows "connecting" again and auto-recovers in place (up to 180 s)
- Stat tiles (Time / Ping / Download / Upload) are now truly centered (EN + FA)
Install
| File | For |
|---|---|
KUVAVpn-v1.2.0-arm64-v8a.apk |
All modern phones (recommended) |
KUVAVpn-v1.2.0-armeabi-v7a.apk |
Older 32-bit phones |
KUVAVpn-v1.2.0-universal.apk |
Any device (larger) |
KUVAVpn-v1.2.0-x86.apk / KUVAVpn-v1.2.0-x86_64.apk |
Intel tablets / emulators |
Minimum Android: 8.0. Updating from v1.1.x installs over the old version
and keeps all your profiles and settings.
Play Protect may warn on install because the APK comes from GitHub —
tap Install anyway.
تغییرات نسخه 1.2.0
✨ قابلیتهای جدید
مسیریابی سایفون در حالت معکوس (Kuva Swift)
- لایهی اختیاری سایفون حالا داخل تونل MASQUE سوار میشود (WARP → Psiphon)
- انتخابگر خروجی با پرچم زنده برای ۲۸ کشور: کارت سریع داشبورد + شیت انتخاب کشور
- در حالت معکوس کل تونل از داخل سایفون برقرار میشود، پس هر بررسیای از خروجی واقعیِ سایفون میگذرد
نوار پیشرفت واقعی Swift
- نوار پیشرفت Swift حالا تماماً مبتنی بر رویدادهای واقعی لاگ هسته است
(هویت → اسکن گیتوی → بهترین گیتوی → TLS → تأیید دیتاپلن → WARP روشن) - برچسب مرحلهی جاری زیر نوار نمایش داده میشود (فارسی + English)
🛠️ رفع مشکلات
نگهبان تونل (Tunnel watchdog)
- قطعشدن تونل (
h2 keepalive timeout،connection aborted) از لاگ هسته شناسایی میشود — پروسهی هسته زنده میماند و خودش دوباره وصل میشود، پس callback های مرگِ پروسه این حالت را نمیدیدند - رابط کاربری صادقانه دوباره «در حال اتصال» نشان میدهد و تا ۱۸۰ ثانیه در جا بازیابی میکند
نصب
حداقل اندروید: ۸.۰. آپدیت از v1.1.x روی نسخهی قبلی نصب میشود و تمام کانفیگها و تنظیمات شما سر جایشان میمانند.
ممکن است Play Protect در هنگام نصب هشدار بدهد، چون APK از گیتهاب دانلود
میشود — روی Install anyway بزنید.
KUVA Vpn v1.1.1
Bugfix release — no new features
Fixed
- Connected but no traffic: the network watcher treated the VPN's own
interface as a "new network" and restarted the tunnel ~1.5 s into
connecting; the restart failed and left a dead tunnel under a Connected
UI. Reconnects are now suppressed while a connection is in flight. - Split tunneling picker: checkboxes did not redraw when tapping apps
(selection worked, UI didn't) — UI state now updates instantly. - Dashboard: removed the duplicate "Searching for route…" label during
Swift scans. - Quick-settings tile no longer desyncs from the dashboard state.
انتشار رفع اشکال (Bugfix Release)
🐛 رفعاشکالات (Fixed)
- متصل اما بدون ترافیک (Connected but no traffic): ناظر شبکه، اینترفیس خودِ VPN را به عنوان یک «شبکه جدید» تشخیص میداد و تقریباً ۱.۵ ثانیه پس از اتصال، تونل را ریاستارت میکرد؛ این ریاستارت با شکست مواجه میشد و یک تونل ازکارافتاده (Dead) را در زیر رابط کاربری با وضعیت «متصل» باقی میگذاشت. اکنون در حین برقراری اتصال، درخواستهای اتصال مجدد سرکوب میشوند.
- انتخابگر تونلزنی تفکیکشده (Split tunneling picker): چکباکسها هنگام ضربه زدن روی برنامهها بازتکثیر و بهروزرسانی نمیشدند (انتخاب انجام میشد اما ظاهر رابط کاربری تغییر نمیکرد) — اکنون وضعیت رابط کاربری به صورت آنی آپدیت میشود.
- داشبورد: برچسب تکراری «Searching for route…» در جریان اسکنهای سریع (Swift scans) حذف شد.
- تنظیمات سریع (Quick-settings): کاشی تنظیمات سریع دیگر با وضعیت داشبورد دچار عدم همگامسازی (desync) نمیشود.
KUVA Vpn v1.1.0
KUVAVpn v1.1.0 — Kuva Swift
The headline feature of this release: Kuva Swift, a second VPN engine that
connects without any profile or subscription at all — one tap and you are
tunneling.
✨ Kuva Swift — serverless engine
- A bundled MASQUE core (official Aether v2.4.0 binaries, AGPL-3.0) finds the
best route on its own: endpoint scan → connect → auto-reconnect. - HTTP/2 (TCP) transport with TLS ClientHello fragmentation to handle
Iran's SNI filtering. IPv4-only. - Engine switch right on the dashboard (Xray Core ⇄ Kuva Swift) plus the
selector in Settings; Xray stays the default after every app start. - Live connecting feedback with scan progress, and verified exit IP display.
⚡ Optimizations
- Auto update check on every app start: a gold banner on the dashboard
("New version available") and a red dot on the Settings tab until you update. - Collapsible settings cards — cleaner Settings screen, tap a card title
to expand it. - Real app exit: EXIT fully ends the process.
🌐 نسخهی فارسی: README.fa.md
KUVAVpn v1.1.0 — Kuva Swift
برجستهترین ویژگی این نسخه: Kuva Swift؛ یک موتور VPN دوم که بدون نیاز به هیچگونه پروفایل یا اشتراکی متصل میشود — فقط یک ضربه و تونلزنی برقرار است.
✨ موتور بدون سرور Kuva Swift
- هسته بستهبندیشدهی MASQUE (باینریهای رسمی Aether v2.4.0 با لایسنس AGPL-3.0) بهطور خودکار بهترین مسیر را پیدا میکند: اسکن پایانه (Endpoint scan) ← اتصال ← اتصال مجدد خودکار.
- انتقال HTTP/2 (TCP) همراه با قطعهبندی (Fragmentation) پروتکل TLS ClientHello برای مدیریت و دور زدن فیلترینگ SNI در ایران (فقط IPv4).
- سوئیچ موتور مستقیماً روی داشبورد (Xray Core ⇄ Kuva Swift) به همراه منوی انتخابگر در بخش تنظیمات؛ ایکسری (Xray) پس از هر بار اجرای برنامه همچنان به عنوان موتور پیشفرض باقی میماند.
- بازخورد زنده اتصال همراه با نمایش درصد پیشرفت اسکن و نمایش IP خروجی تأییدشده.
⚡ بهینهسازی
- بررسی خودکار بهروزرسانی در هر بار اجرا: نمایش یک بنر طلایی روی داشبورد («New version available») و یک نقطه قرمز روی تب تنظیمات تا زمان انجام بهروزرسانی.
- کارتهای تنظیمات قابل جمعشدن (Collapsible): ساخت صفحه تنظیمات به شکل تمیزتر و مرتبتر؛ برای باز کردن هر کارت کافیست روی عنوان آن ضربه بزنید.
- خروج واقعی از برنامه: گزینه EXIT پردازش برنامه را به طور کامل خاتمه میدهد.
KUVA Vpn v1.0.3
--notes "Fixed in-app update: install confirmation dialog now appears; install-permission gate. Settings > Check for updates now works end-to-end."
KUVA Vpn v1.0.2
--notes "Full JSON config import: v2rayNG/v2Box full exports (xhttp, httpupgrade, websocket), post-quantum vless encryption, spiderX, clipboard JSON import"
KUVAVpn v1.0.1
--notes "### What's new
- Battery: notification refresh reduced (2s screen-on / 15s screen-off), UI stats still 1Hz
- Import: multi-line JSON configs supported (full Xray JSON with outbounds)
- Updates: in-app updater from GitHub Releases — download and install without leaving the app
- Flags: 96 country flags bundled offline — flag appears instantly with location, no network image
- Dev: ABI splits release-only — debug builds package 1 APK instead of 5
Install: pick the APK matching your phone CPU (most phones: arm64-v8a). Updating from v1.0.0 installs over it — settings and data are kept."
KUVAVpn 1.0.0
First public release of KUVAVpn.
- Xray-core 26.10.31 with VLESS / VMess / Trojan / Shadowsocks
- REALITY, XHTTP, gRPC and WebSocket transports
- Import configs from vless:// / vmess:// / trojan:// / ss:// links, QR code, or clipboard
- Bypass Iranian sites: banks and government services stay direct (bundled Loyalsoldier geo databases, in-app update from GitHub)
- Split tunneling, custom DNS, built-in ping & speed test
- Dark UI, English and Persian, no accounts, no analytics, no telemetry
Downloads:
| File | For |
|---|---|
KUVAVpn-v1.0.0-arm64-v8a.apk |
All modern phones (recommended) |
KUVAVpn-v1.0.0-armeabi-v7a.apk |
Older 32-bit phones |
KUVAVpn-v1.0.0-universal.apk |
Works on any device (larger) |
KUVAVpn-v1.0.0-x86.apk |
Intel-based tablets/emulators |
KUVAVpn-v1.0.0-x86_64.apk |
64-bit Intel/emulators |
Install: download the APK for your device, allow "Install unknown apps" for your browser, install and open.
Minimum Android: 8.0 (API 26)