-
-
Notifications
You must be signed in to change notification settings - Fork 12
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
493b886
commit 0f238f3
Showing
3 changed files
with
138 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,145 @@ | ||
# odin | ||
<h1 align="center" style="border-bottom: none"> | ||
<b> | ||
<p><img src="assets/icon.png" alt="icon" width=20> Odin</p><br> | ||
</b> | ||
⚡ Open source easy file sharing for everyone. ⚡ <br> | ||
</h1> | ||
|
||
A new Flutter project. | ||
|
||
<p align="center"> | ||
<a href="https://flutter.dev/"><img src="https://img.shields.io/badge/Flutter-v2.5.1-blue?logo=flutter"></a> | ||
<a href="https://github.com/odinapp/odin"><img src="https://img.shields.io/github/stars/odinapp/odin.svg?style=flat&logo=github&colorB=deeppink&label=stars"></a> | ||
<a href="https://github.com/odinapp/odin"><img src="https://img.shields.io/github/v/release/odinapp/odin.svg"></a> | ||
<a href="https://github.com/odinapp/odin"><img src="https://img.shields.io/github/license/odinapp/odin.svg" alt="License: AGPL"></a> | ||
|
||
</p> | ||
|
||
|
||
|
||
<p align="center"> | ||
Cross-platform hassle-free file sharing with AES-256 encryption made with Flutter & Dart. | ||
</p> | ||
|
||
|
||
<p align="center"> | ||
<a href="#Getting Started"><b>Getting Started</b></a> • | ||
<a href="#Roadmap"><b>Roadmap</b></a> • | ||
<a href="#Releases"><b>Releases</b></a> | ||
|
||
|
||
|
||
|
||
</p> | ||
|
||
<p align="center"><img src="assets/header.png" alt="Open source easy file sharing for everyone." width="1000px" /></p> | ||
|
||
|
||
|
||
## Built With | ||
|
||
* [Flutter](https://flutter.dev/) | ||
|
||
* [Dart](https://dart.dev/) | ||
|
||
## Getting Started | ||
|
||
This project is a starting point for a Flutter application. | ||
To build on MacOS or Windows, please follow these simple steps. | ||
|
||
**Step 1:** | ||
|
||
```shell | ||
git clone https://github.com/odinapp/odin.git | ||
``` | ||
|
||
**Step 2:** | ||
|
||
```shell | ||
cd odin | ||
``` | ||
```shell | ||
touch .env | ||
``` | ||
```shell | ||
echo 'GITHUB_TOKEN=**GITHUB_ACCESS_TOKEN**' >> .env | ||
``` | ||
```shell | ||
echo 'GITHUB_USERNAME=**GITHUB_USERNAME**' >> .env | ||
``` | ||
```shell | ||
echo 'GITHUB_TOKEN=**GITHUB_TOKEN**' >> .env | ||
``` | ||
|
||
> | ||
> | ||
> These environment variables are required as Odin uses a GitHub Repo to store the uploaded files. | ||
> You may read GitHub docs to access these secrets. | ||
**Step 3:** | ||
|
||
Follow the instructions [here](https://flutter.dev/docs/get-started/install) to install Flutter. As Odin uses the `stable` channel, you need to switch the channel if you are on `dev` or `beta` channels. Just type: | ||
|
||
```shell | ||
flutter channel stable | ||
``` | ||
|
||
**Step 4:** | ||
|
||
You should enable the specified platform first if you don't enable it before and then select the desktop device. | ||
```shell | ||
# for windows | ||
flutter config --enable-windows-desktop | ||
|
||
# for macos | ||
flutter config --enable-macos-desktop | ||
|
||
# for linux | ||
flutter config --enable-linux-desktop | ||
``` | ||
|
||
**Step 5:** | ||
|
||
To run the app just type these commands in terminal or use the Run and Debug option from your editor of choice. | ||
```shell | ||
flutter pub get | ||
flutter run | ||
``` | ||
## Roadmap | ||
|
||
``` | ||
Roadmap | ||
|-- AES-256 encryption | ||
|-- Online website | ||
| |-- Upload and share files from any device | ||
| |-- View encrypted files and download them safely | ||
|-- Upload / Download Progress | ||
|-- File Deletion within 15 hours | ||
|-- Same network direct sharing | ||
``` | ||
|
||
If you'd like to propose a feature, submit an issue [here](https://github.com/odinapp/odin/issues). | ||
|
||
## Releases | ||
|
||
Please see the [releases tab](https://github.com/odinapp/odin/releases) for more details about the latest release. | ||
|
||
## Contributing | ||
First off, thanks for visiting Odin's repo and taking your time to read this doc. | ||
Any contributions you make are **greatly appreciated**. Please look at [CONTRIBUTING.md](https://github.com/odinapp/odin/blob/main/doc/CONTRIBUTING.md) for details. | ||
|
||
## What is Odin? | ||
Odin began as what most projects start as "A weekend project". Originally, we wanted to develop a cross-platform, open-source file-sharing platform that was faster and easier than sharing files over chat services or data cables. | ||
We wanted to develop and prototype the project as quickly as possible. The result was an MVP that was ready in just a few hours because we used Flutter. | ||
|
||
> Fun Fact: The app icon resembles the helmet of the god Odin from Norse mythology. It also resembles a free-flying bird, which indicates our feelings while developing this with Flutter😊. | ||
## License | ||
|
||
Distributed under the AGPLv3 License. See `LICENSE.md` for more information. | ||
|
||
A few resources to get you started if this is your first Flutter project: | ||
## Contributers | ||
|
||
- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab) | ||
- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook) | ||
<a href="https://github.com/odinapp/odin/graphs/contributors"> | ||
<img src="https://contributors-img.web.app/image?repo=odinapp/odin" /> | ||
</a> | ||
|
||
For help getting started with Flutter, view our | ||
[online documentation](https://flutter.dev/docs), which offers tutorials, | ||
samples, guidance on mobile development, and a full API reference. | ||
### If you made it here, thanks for your support. You can show more support by starring this repo. See ya! 👋 |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.