diff --git a/README.md b/README.md index a6fa4c3..9ee24d6 100644 --- a/README.md +++ b/README.md @@ -18,9 +18,9 @@ - [๐Ÿ“ Overview](#-overview) - [๐Ÿงฉ Screenshots](#-screenshots) - [๐Ÿš€ Getting Started](#-getting-started) +- [โŒจ๏ธ Development](#๏ธ-development) - [โ˜‘๏ธ Prerequisites](#-prerequisites) - [โš™๏ธ Installation](#-installation) - - [๐Ÿค– Usage](#๐Ÿค–-usage) - [๐Ÿ“Œ Project Roadmap](#-project-roadmap) - [๐Ÿ”ฐ Contributing](#-contributing) - [๐ŸŽ— License](#-license) @@ -34,17 +34,59 @@ * Support multiple telegram accounts for downloading files. * Support suspending and resuming downloads. * Multiple accounts with same files will be downloaded only once. +* Responsive design supports mobile access. --- ## ๐Ÿงฉ Screenshots -

- -

+
+ + +
+ +
+More Screenshots +
+ + +
+
## ๐Ÿš€ Getting Started +Before getting started with telegram-files, you should apply a telegram api id and hash. You can apply for it on the [Telegram API](https://my.telegram.org/apps) page. + +**Using `docker`** +  [](https://www.docker.com/) + +```shell +docker run -d \ + --name telegram-files \ + --restart always \ + -e APP_ENV=${APP_ENV:-prod} \ + -e APP_ROOT=${APP_ROOT:-/app/data} \ + -e TELEGRAM_API_ID=${TELEGRAM_API_ID} \ + -e TELEGRAM_API_HASH=${TELEGRAM_API_HASH} \ + -p 6543:80 \ + -v ./data:/app/data \ + ghcr.io/jarvis2f/telegram-files:latest +``` + +**Using `docker-compose`** + +Copy [docker-compose.yaml](docker-compose.yaml) to your project directory and run the following command: + +```sh +docker-compose up -d +``` + +> **Important Note:** You should NOT expose the service to the public internet. Because the service is not secure. + +--- + +## โŒจ๏ธ Development + ### โ˜‘๏ธ Prerequisites Before getting started with telegram-files, ensure your runtime environment meets the following requirements: @@ -96,27 +138,12 @@ gradle build docker build -t jarvis2f/telegram-files . ``` -### ๐Ÿค– Usage - -**Using `docker`** -  [](https://www.docker.com/) - -Copy [docker-compose.yaml](docker-compose.yaml) to your project directory and run the following command: - -```sh -docker-compose up -d -``` - -> **Important Note:** You should NOT expose the service to the public internet. Because the service is not secure. - ---- - ## ๐Ÿ“Œ Project Roadmap -- [ ] **`Task 1`**: Improve Telegramโ€™s login functionality. -- [ ] **`Task 2`**: Support auto transfer files to other destinations. -- [ ] **`Task 3`**: Automatically download files based on set rules. -- [ ] **`Task 4`**: Download statistics and reports. +- โœ… **`Task 1`**: Automatically download files based on set rules. +- โœ… **`Task 2`**: Download statistics and reports. +- โ˜‘๏ธ **`Task 3`**: Improve Telegramโ€™s login functionality. +- โ˜‘๏ธ **`Task 4`**: Support auto transfer files to other destinations. --- @@ -178,5 +205,6 @@ refer to the [LICENSE](LICENSE) file.
Use in http environment, you can use the following method to solve it -Open the `chrome://flags` page, search for `Insecure origins treated as secure`, and add the address of the web page to the list. +Open the `chrome://flags` page, search for `Insecure origins treated as secure`, and add the address of the web page to +the list.
diff --git a/misc/screenshot-2.png b/misc/screenshot-2.png new file mode 100644 index 0000000..ac92f23 Binary files /dev/null and b/misc/screenshot-2.png differ diff --git a/misc/screenshot-3.png b/misc/screenshot-3.png new file mode 100644 index 0000000..6fcc69c Binary files /dev/null and b/misc/screenshot-3.png differ diff --git a/misc/screenshot-4.png b/misc/screenshot-4.png new file mode 100644 index 0000000..c6cd64d Binary files /dev/null and b/misc/screenshot-4.png differ