From 38f3af752ae463e21a7484931f06e13f7528ada7 Mon Sep 17 00:00:00 2001 From: Cris <22254235+o0101@users.noreply.github.com> Date: Fri, 23 Aug 2024 13:13:49 +0800 Subject: [PATCH] Update README.md Signed-off-by: Cris <22254235+o0101@users.noreply.github.com> --- README.md | 145 ++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 118 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index 46bcaa4..f286e71 100644 --- a/README.md +++ b/README.md @@ -1,48 +1,139 @@ -# DownloadNet: An Archive of Your Online Journey +# :floppy_disk: [DownloadNet (dn)](https://github.com/dosyago/DownloadNet) – Your Offline Web Archive with Full Text Search ![source lines of code](https://sloc.xyz/github/crisdosyago/Diskernet) -![npm downloads (22120)](https://img.shields.io/npm/dt/archivist1?label=npm%20downloads%20%2822120%29) -![npm downloads (downloadnet, since Jan 2022)](https://img.shields.io/npm/dt/downloadnet?label=npm%20downloads%20%28downloadnet%2C%20since%20Jan%202022%29) ![binary downloads](https://img.shields.io/github/downloads/c9fe/22120/total?label=OS%20binary%20downloads) ![visitors+++](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fc9fe%2F22120&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=%28today%2Ftotal%29%20visitors%2B%2B%2B%20since%20Oct%202020&edge_flat=false) -![version](https://img.shields.io/npm/v/downloadnet) ![DownloadNet slogan](https://img.shields.io/badge/%F0%9F%92%BE%20DownloadNet-an%20internet%20on%20yer%20disc-hotpink) -DownloadNet empowers you to be the master archivist of your own internet browsing. As a robust, lightweight tool, DownloadNet seamlessly connects to your browser, saving and organizing your online discoveries in real-time. With an option to archive everything or only bookmark-worthy content, DownloadNet places you in full control of your browsing history. No special plugins or extensions required. +Imagine a world where everything you browse online is saved and accessible, even when you're offline. That's the magic of DownloadNet (dn). -## Why DownloadNet? +## Why dn? -- **Access**: Keep track of your online finds without breaking a sweat. -- **Efficiency**: Find your saved content fast, saving you time for more exploration. -- **Flexibility**: Share your archive with others or maintain your digital solitude. -- **Simplicity**: No frills, no fuss. DownloadNet is straightforward to use, requiring no extra tools or plugins. -- **Organization**: Search through everything you've archived with full text search of all archived content. Your own personal search engine. - -## Latest Updates +- **Seamless Offline Experience** :earth_africa:: With dn, your offline browsing feels exactly like being online. It hooks directly into your browser, caching every page you visit, so you never lose track of that one article or resource you meant to revisit. +- **Full Text Search** :mag:: Unlike other archiving tools, dn gives you the power to search through your entire archive. No more digging through countless files—just search and find. +- **Completely Private** :lock:: Everything is stored locally on your machine. Browse whatever you want, with the peace of mind that it's all private and secure. -**Local SSL Certificates Now Supported!** :lock: :tada: +## Getting Started -Ensure your DownloadNet server runs over TLS with our support for local SSL certificates. +### 1. **Download a Pre-built Binary (Simplest Option)** :package: +If you’re not familiar with Git or npm, this is the easiest way to get started: -## Licensing +1. **Go to the [Releases Page](https://github.com/dosyago/DownloadNet/releases)** +2. **Download** the binary for your operating system (e.g., Windows, macOS, Linux). +3. **Run** the downloaded file. That’s it! You’re ready to start archiving. -DownloadNet is protected under the APGL-3.0 +### 2. **Install via npm (For Users Familiar with Command Line)** :rocket: -## Get DownloadNet +1. **Open your terminal** (Command Prompt on Windows, Terminal on macOS/Linux). +2. **Install dn globally** with npm: + ```sh + npm i -g downloadnet@latest + ``` +3. **Start dn** by typing: + ```sh + dn + ``` -[Download a release](https://github.com/dosyago/DownloadNet/releases) +> [!NOTE] +> Make sure you have Node.js installed before attempting to use npm. If you're new to npm, see the next section for guidance. -or ... +### 3. **New to npm? No Problem!** :bulb: -Install via **[npm](https://www.npmjs.com/package/downloadnet)**: +If you’ve never used npm before, don’t worry—it’s easy to get started. -```sh -$ npm i -g downloadnet@latest -``` +- **What is npm?** npm is a package manager for Node.js, a JavaScript runtime that allows you to run server-side code. You’ll use npm to install and manage software like dn. +- **Installing Node.js and npm:** The easiest way to install Node.js (which includes npm) is by using Node Version Manager (nvm). This tool allows you to easily install, manage, and switch between different versions of Node.js. +**To install nvm:** -Welcome! Get involved. :) +1. **Visit the [nvm GitHub page](https://github.com/nvm-sh/nvm#installing-and-updating)** for installation instructions. +2. **Follow the steps** to install nvm on your system. +3. Once nvm is installed, **install the latest version of Node.js** by running: + ```sh + nvm install node + ``` +4. Now you can install dn using npm as described in the section above! -------- -Navigate your digital world with DownloadNet. Download and start archiving today! +> [!TIP] +> Using nvm allows you to easily switch between Node.js versions and manage your environment more effectively. +### 4. **Build Your Own Binary (For Developers or Power Users)** :hammer_and_wrench: + +If you like to tinker and want to build the binary yourself, here’s how: + +1. **Download Git:** If you haven’t used Git before, download and install it from [git-scm.com](https://git-scm.com/). +2. **Clone the Repository:** + ```sh + git clone https://github.com/dosyago/DownloadNet.git + ``` +3. **Navigate to the Project Directory:** + ```sh + cd DownloadNet + ``` +4. **Install Dependencies:** + ```sh + npm i + ``` +5. **Build the Binary:** + ```sh + npm run build + ``` + +6. **Find Your Binary:** The newly built binary will be in the `./build/bin` directory, ready to be executed! + +### 5. **Run Directly from the Repository (Quick Start)** :runner: + +Want to get dn up and running without building a binary? No problem! + +1. **Clone the Repository:** + ```sh + git clone https://github.com/dosyago/DownloadNet.git + ``` +2. **Navigate to the Project Directory:** + ```sh + cd DownloadNet + ``` +3. **Install Dependencies:** + ```sh + npm i + ``` +4. **Start dn:** + ```sh + npm start + ``` + +And just like that, you’re archiving! + +## How It Works + +dn runs as an intercepting proxy, hooking into your browser's internal fetch cycle. Once you fire up dn, it automatically configures your browser, and you’re good to go. Everything you browse is archived, and you can choose to save everything or just what you bookmark. + +### Modes: + +- **Save Mode** :floppy_disk:: Archive and index as you browse. +- **Serve Mode** :open_file_folder:: Browse your saved content as if you were still online. + +> [!CAUTION] +> As your archive grows, you may encounter performance issues. If that happens, you can adjust the memory settings by setting environment variables for NODE runtime arguments, like `--max-old-space-size`. + +## Accessing Your Archive + +Once dn is running, your archive is at your fingertips. Just go to `http://localhost:22120` in your browser. Your archive’s control panel opens automatically, and from there, you can search, configure settings, and explore everything you’ve saved. + +## Minimalistic Interface, Maximum Power + +dn’s interface is basic but functional. It’s not about flashy design; it’s about delivering what you need—offline access to the web, as if you were still connected. + +## Advanced Settings (If Needed) + +As your archive grows, you may want to adjust where it's stored, manage memory settings, or blacklist domains you don’t want to archive. All of these settings can be tweaked directly from the control panel or command line. + +## Get Started Now + +With dn, you’ll never lose track of anything you’ve read online. It’s all right there in your own offline archive, fully searchable and always accessible. Whether you're in save mode or serve mode, dn keeps your digital life intact. + +**:arrow_down: Download** | **:rocket: Install** | **:runner: Run** | **:mag_right: Never Lose Anything Again** + +[Get Started with dn](https://github.com/dosyago/DownloadNet) + +----