Skip to content

TheInkReaper/SoulTether

Repository files navigation

⚡ SoulTether

Silent & Anonymous Personal Safety / Seguridad Personal Silenciosa y Anónima

Android Kotlin License

🇺🇸 Read in English | 🇪🇸 Leer en Español


🇺🇸 English

SoulTether is a personal safety application designed to offer discreet help without compromising your privacy. Unlike other apps, SoulTether requires no registration (no email/phone) and uses no cloud servers to store your history. Everything stays on your device.

📥 Download

Get the latest version (.apk) from the Releases section: ⬇️ Download SoulTether v1.0

📖 Full Guide & Features

1. Privacy & Anonymity

We operate via anonymous IDs generated locally on your device. We do not store your history in the cloud. You are free and invisible.

2. You are in Control

You can remove a Guardian from your list at any time. The other person will NOT receive any notification. The link is simply severed: you stop receiving their Echoes and they stop receiving your alerts. We prioritize your safety and comfort.

3. Your Circle of Trust

  • Protege: Sends the help signal.
  • Guardian: Receives the signal and sends support "Echoes".
  • Note: You can be both a Guardian and a Protege at the same time with different people.

4. Asking for Help (The Alert)

Pressing the central button triggers the alert to your Guardians.

  • Customizable Message: You can configure the message in Settings to express exactly what you need (e.g., "silent company", "a call", "time together", or "I am not okay").
  • Location (Optional): You can choose to attach your GPS location to the alert so Guardians know where to find you physically.

5. Daily Energy & Loveletters

  • Energy Check: Update your "battery" on the Home screen.
  • Low Energy Support: If your energy drops below 2/5, the app will suggest contacting someone and automatically display "Loveletters".
  • Loveletters: Special bond messages your Guardian writes when adding you. They serve as a visual reminder that you are not alone.

6. Echoes

Guardians can send "Echoes": gentle, pre-defined messages to say "thinking of you" without demanding an immediate response or conversation. Ideally used to support Proteges without pressure.

7. Communication Channels

  • App Alerts: Primary, free, and secure.
  • SMS Backup: Falls back to SMS if internet is unavailable (configurable).
  • Future: WhatsApp/Telegram/Discord integration coming soon.

8. Quick Access Widget

Add the "Alert Button" to your home screen. It mimics a standard app icon but acts as an instant trigger to call for help without opening the app. It vibrates twice to confirm the signal was sent.

9. Incognito Mode (Calculator)

Disguise the app as a Fully Functional Calculator via Settings > Security.

  • Access PIN (Default 5555): Type it and press = to unlock SoulTether.
  • Panic Code (Default 0000): Type it and press = to trigger a silent alert while simulating a calculation error.

🛠️ Tech Stack

  • Language: Kotlin
  • UI: Jetpack Compose (Material 3)
  • Database: Room (Local SQLite)
  • Architecture: MVVM

🇪🇸 Español

SoulTether es una aplicación de seguridad personal diseñada para ofrecer ayuda discreta sin comprometer tu privacidad. A diferencia de otras apps, SoulTether no requiere registro (email/teléfono) y no utiliza servidores en la nube para almacenar tu historial. Todo se queda en tu dispositivo.

📥 Descarga

Puedes descargar la última versión (.apk) desde la sección de Releases: ⬇️ Descargar SoulTether v1.0

📖 Guía Completa y Funciones

1. Privacidad y Anonimato

Funcionamos mediante IDs anónimos en tu dispositivo. No almacenamos tu historial en la nube. Eres libre e invisible.

2. Tú tienes el control

Puedes eliminar a un Guardián de tu lista en cualquier momento. La otra persona NO recibirá ninguna notificación. Simplemente, el vínculo se cortará: dejarás de recibir sus Ecos y ellos dejarán de recibir tus alertas. Priorizamos tu seguridad y confort.

3. Tu Círculo de Confianza

  • Protegido: Envía la señal de ayuda.
  • Guardián: Recibe la señal y envía "Ecos" de apoyo.
  • Nota: Puedes ser Guardián y Protegido a la vez con diferentes personas.

4. Pedir Ayuda (La Alerta)

Al pulsar el botón central, avisarás a tus Guardianes.

  • Mensaje Personalizado: Puedes configurar el mensaje en Ajustes para expresar lo que necesitas ("compañía silenciosa", "una llamada", "tiempo juntos", "estoy mal").
  • Ubicación (Opcional): Puedes decidir si adjuntar tu ubicación GPS a la alerta para que sepan dónde estás físicamente.

5. Energía Diaria y Loveletters

  • Batería Social: Actualiza tu nivel de energía en el Inicio.
  • Soporte en Baja Energía: Si baja de 2/5, la app te sugerirá contactar y mostrará las "Loveletters" de tus Guardianes en pantalla.
  • Loveletters: Mensajes especiales de vínculo que tu Guardián escribe al añadirte. Son un recordatorio visual de que no estás solo.

6. Ecos

Los Guardianes envían "Ecos": mensajes suaves para decir "pienso en ti" sin exigir respuesta inmediata ni iniciar una conversación forzada.

7. Canales de Comunicación

  • Alertas vía App: Canal principal, seguro y gratis.
  • Respaldo SMS: Se activa si falla internet (configurable).
  • Futuro: Estamos trabajando para integrar WhatsApp, Telegram y Discord.

8. Widget de Acceso Rápido

Añade el "Botón Alerta" a tu pantalla de inicio. Se camufla como un icono normal, pero funciona como un botón físico para pedir ayuda al instante sin abrir la app. Vibrará dos veces para confirmar.

9. Modo Incógnito (Calculadora)

Actívalo en Ajustes > Seguridad para camuflar la app como una calculadora totalmente funcional.

  • PIN de Acceso (Default 5555): Escríbelo y pulsa = para entrar a SoulTether.
  • Código de Alerta (Default 0000): Escríbelo y pulsa = para enviar una alerta silenciosa simulando un error de cálculo.

🛠️ Tecnología

  • Lenguaje: Kotlin
  • UI: Jetpack Compose (Material 3)
  • Base de Datos: Room (SQLite Local)
  • Arquitectura: MVVM

📸 Screenshots / Capturas

s1

Demo de Interacción Real

compressed-vdxxOn0X.mp4

📄 License / Licencia

This project is licensed under the MIT License - see the LICENSE file for details. Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

Disclaimer: This app is a personal support tool and does not replace professional emergency services (112/911). Aviso: Esta aplicación es una herramienta de apoyo personal y no sustituye a los servicios de emergencia profesionales (112/911).

About

Silent, anonymous personal safety app. Botón de pánico silencioso y anónimo.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages