Giter Club home page Giter Club logo

oblivion's Introduction

Oblivion - Unofficial Warp Client for Android

"Internet, for all or none!"

Oblivion provides secure, optimized internet access through a user-friendly Android app using cloudflare warp technology

It's leveraging bepass-sdk and a custom Go implementation of WireGuard, it's designed for fast and private online experiences.

Features

  • Secure VPN: Custom WireGuard implementation in Go.
  • Optimized Speeds: Enhanced with bepass-sdk for minimal latency.
  • User-Friendly: Simple, intuitive interface.

Quick Start

  1. Download: Grab the APK from our Releases page.
  2. Install: Open the APK file to install.
  3. Connect: Launch Oblivion and hit the switch button.

Building the Project

Prerequisites

  • Java 17
  • Gradle 8
  • Android Gradle Plugin (AGP) 8.1.2
  • NDK r26b (26.1.10909125)
  • Go 1.20.0

Follow the steps below to build the Oblivion:

Building Go libraries

Open the Terminal tab at the bottom of Android Studio.

Navigate to the libs directory:

cd app/libs

Initialize Go modules and install required packages:

go mod tidy
go install golang.org/x/mobile/cmd/gomobile@latest
go install golang.org/x/mobile/cmd/gobind@latest
go get golang.org/x/mobile/cmd/gobind
go get golang.org/x/mobile/cmd/gomobile
go get golang.org/x/mobile

Initialize Go mobile:

gomobile init

Bind the Go package to Android:

gomobile bind -ldflags '-s -w' -o tun2socks.aar -androidapi 21 -target android .

Generate Signed Bundle/APK:

  • In Android Studio, navigate to "Build" in the menu bar.
  • Select "Generate Signed Bundle/APK..."
  • Choose "APK" and proceed.

Select Keystore:

  • Click on "Choose existing..." or "Create new..." to locate your keystore file.
  • Enter the keystore password when prompted.

Configure APK Signature:

  • Select the appropriate key alias from the dropdown menu.
  • Input the key password.
  • Continue to the next step.

Select APK Destination:

  • Choose the destination folder for the signed APK.
  • Finalize by clicking "Finish" to generate the signed APK.

Get Involved

We're a community-driven project, aiming to make the internet accessible for all. Whether you want to contribute code, suggest features, or need some help, we'd love to hear from you! Check out our GitHub Issues or submit a pull request.

Acknowledgements and Credits

This project makes use of several open-source tools and libraries, and we are grateful to the developers and communities behind these projects. In particular, we would like to acknowledge:

Cloudflare Warp

  • Project: Cloudflare Warp
  • Website: Cloudflare Warp
  • License: License information
  • Description: Cloudflare Warp is a technology that enhances the security and performance of Internet applications. We use it in our project for its efficient and secure network traffic routing capabilities.

WireGuard-go

  • Project: WireGuard-go
  • GitHub Repository: WireGuard-go on GitHub
  • License: GNU General Public License v2.0
  • Description: WireGuard-go is an implementation of the WireGuard secure network tunnel. It's used in our project to provide fast, modern, and secure VPN tunneling.

Please note that the use of these tools is governed by their respective licenses, and you should consult those licenses for terms and conditions of use.

License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License - see the CC BY-NC-SA 4.0 License for details.

Summary of License

The CC BY-NC-SA 4.0 License is a free, copyleft license suitable for non-commercial use. Here's what it means for using this project:

  • Attribution (BY): You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.

  • NonCommercial (NC): You may not use the material for commercial purposes.

  • ShareAlike (SA): If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

This summary is only a brief overview. For the full legal text, please visit the provided link.

oblivion's People

Contributors

danielcoderx avatar uoosef avatar mohamadkhalaj avatar ircfspace avatar amillinium avatar comm4nd3rx avatar vaccine919 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.