diff --git a/docs/docs/contribution-guidelines.md b/docs/docs/contribution-guidelines.md index 5e1cdbfb4a..e9878c19a8 100644 --- a/docs/docs/contribution-guidelines.md +++ b/docs/docs/contribution-guidelines.md @@ -38,7 +38,7 @@ Please refer to the [Flutter's official documentation](https://flutter.dev/docs/ ### Lint / format extensions -Setting these in the IDE give a better developer experience auto-formatting code on save and providing instant feedback on lint issues. +Setting these in the IDE give a better developer experience, auto-formatting code on save, and providing instant feedback on lint issues. ### VSCode @@ -79,4 +79,4 @@ OpenAPI is used to generate the client (Typescript, Dart) SDK. `openapi-generato ```bash npm run api:generate # Run from the `server` directory ``` -You can find the generated client SDK in the `web/src/api` for Typescript SDK and `mobile/openapi` for Dart SDK. \ No newline at end of file +You can find the generated client SDK in the `web/src/api` for Typescript SDK and `mobile/openapi` for Dart SDK. diff --git a/docs/docs/installation/one-step-installation.md b/docs/docs/installation/one-step-installation.md index 41c5dab341..49ab16be9f 100644 --- a/docs/docs/installation/one-step-installation.md +++ b/docs/docs/installation/one-step-installation.md @@ -5,10 +5,10 @@ sidebar_position: 2 # One-step installation :::caution -This method is for evaluation purposes only. It is not recommended for production use. For production usage, please refer to the recommneded installation method [here](/docs/installation/recommended-installation). +This method is for evaluation purposes only. It is not recommended for production use. For production usage, please refer to the recommended installation method [here](/docs/installation/recommended-installation). ::: -In the shell, from the directory of your choice, run the following command: +In the shell, from a directory of your choice, run the following command: ```bash curl -o- https://raw.githubusercontent.com/immich-app/immich/main/install.sh | bash @@ -26,4 +26,4 @@ The directory which is used to store the backup file is `./immich-app/immich-dat :::tip For more information on how to use the application, please refer to the [Post Installation](/docs/usage/post-installation) guide. -::: \ No newline at end of file +::: diff --git a/docs/docs/installation/recommended-installation.md b/docs/docs/installation/recommended-installation.md index 38b54d1612..5bffffafa2 100644 --- a/docs/docs/installation/recommended-installation.md +++ b/docs/docs/installation/recommended-installation.md @@ -103,7 +103,7 @@ PUBLIC_LOGIN_PAGE_MESSAGE="My Family Photos and Videos Backup Server" * Populate custom database information if necessary. * Populate `UPLOAD_LOCATION` as prefered location for storing backup assets. -* Populate a secret value for `JWT_SECRET`, you can use the command below to generate a secured key +* Populate a secret value for `JWT_SECRET`, you can use the command below to generate a secure key ```bash title="Command to generate secure JWT_SECRET key" openssl rand -base64 128 @@ -117,4 +117,4 @@ docker-compose up -d # or `docker compose up -d` based on your docker-compose ve :::tip For more information on how to use the application, please refer to the [Post Installation](/docs/usage/post-installation) guide. -::: \ No newline at end of file +::: diff --git a/docs/docs/installation/requirements.md b/docs/docs/installation/requirements.md index f1e5d09d46..b1641ba488 100644 --- a/docs/docs/installation/requirements.md +++ b/docs/docs/installation/requirements.md @@ -4,7 +4,7 @@ sidebar_position: 1 # Requirements -Hardware and software requirement for Immich +Hardware and software requirements for Immich ## Software @@ -12,18 +12,18 @@ Hardware and software requirement for Immich - [Docker Compose](https://docs.docker.com/compose/install/) :::info Podman -You can also use Podman to run the application, however, additional configurations might required on your end. +You can also use Podman to run the application. However, additional configurations might be required on your end. ::: ## Hardware -- **OS**: Preferred unix-based operating system (Ubuntu, Debian, MacOS...etc). Windows works too with [Docker Desktop on Windows](https://docs.docker.com/desktop/install/windows-install/) +- **OS**: Preferred unix-based operating system (Ubuntu, Debian, MacOS...etc). Windows works too, with [Docker Desktop on Windows](https://docs.docker.com/desktop/install/windows-install/) - **Ram**: At least 2GB, preferred 4GB. - **Core**: At least 2 cores, preferred 4 cores. ## Installation methods -There are a couple installation method that you can use to install the application. You can choose the one that suits you the best. +There are a couple installation methods that you can use to install the application. You can choose the one that suits you the best. 1. [One-step installation (Evaluation only)](/docs/installation/one-step-installation) 2. **[Docker Compose with manual configuration (Recommended)](/docs/installation/recommended-installation)** diff --git a/docs/docs/overview/introduction.mdx b/docs/docs/overview/introduction.mdx index de790e456b..267cae8617 100644 --- a/docs/docs/overview/introduction.mdx +++ b/docs/docs/overview/introduction.mdx @@ -12,14 +12,14 @@ Hello, I am glad you are here.

-My name is Alex. I am an Electrical Engineer by schooling, then turned into a Software Engineer by trade, and by the pure love of problem solving. +My name is Alex. I am an Electrical Engineer by schooling, then turned into a Software Engineer by trade and the pure love of problem solving. -We were lying in bed with our newborn, and my wife said, "We are starting to accumulate a lot of photos and videos of our baby and I don't want to pay for **_App-Which-Must-Not-Be-Named_** anymore, and you always want to build something for me. So why don't you build me an app which can do that?" +We were lying in bed with our newborn, and my wife said, "We are starting to accumulate a lot of photos and videos of our baby, and I don't want to pay for **_App-Which-Must-Not-Be-Named_** anymore. You always want to build something for me, so why don't you build me an app which can do that?" -That was how the idea started to grow in my head. After that, I began to find existing solutions in the self-hosting space with similar backup functionality and the performance level of the **_App-Which-Must-Not-Be-Named_**. As a result, the current solutions mainly focus on the gallery-type application. However, I want a simple-to-use backup tool with a native mobile app that can view photos and videos efficiently. So I set sail on this journey as a hungry engineer on the hunt. +That was how the idea started to grow in my head. After that, I began to find existing solutions in the self-hosting space with similar backup functionality and the performance level of the **_App-Which-Must-Not-Be-Named_**. I found that the current solutions mainly focus on the gallery-type application. However, I want a simple-to-use backup tool with a native mobile app that can view photos and videos efficiently. So I set sail on this journey as a hungry engineer on the hunt. Another motivation that pushed me to deliver my execution of the **_App-Which-Must-Not-Be-Named_** alternative or replacement is for contributing back to the open source community that I have greatly benefited from over the years. -I'm proud to share this creation with you, who values privacy, memories, and the joy of looking back at those moments in an easy-to-use and friendly interface. +I'm proud to share this creation with you, which values privacy, memories, and the joy of looking back at those moments in an easy-to-use and friendly interface. -If you like the application or it helps you in someway, please consider [supporting](./support-the-project.md) to the project. It will help me to continue to develop and maintain the application. +If you like the application or it helps you in some way, please consider [supporting](./support-the-project.md) to the project. It will help me to continue to develop and maintain the application. diff --git a/docs/docs/overview/logo-mearning.md b/docs/docs/overview/logo-mearning.md index 1a059b8c68..f279c421ff 100644 --- a/docs/docs/overview/logo-mearning.md +++ b/docs/docs/overview/logo-mearning.md @@ -4,14 +4,14 @@ sidebar_position: 2 # Logo meaning -Why the colorful flower, you asked? +Why the colorful flower, you ask? -I really like the Japanese culture, especially books, history, and food. The current logo is a spin-off of [the Oda clan's symbol](https://en.wikipedia.org/wiki/Oda_clan). +I really like the Japanese culture, especially the books, history, and food. The current logo is a spin-off of [the Oda clan's symbol](https://en.wikipedia.org/wiki/Oda_clan). ![Oda_emblem](https://user-images.githubusercontent.com/27055614/182044504-a5ed33a8-5640-42de-b359-18fdbee9fb90.svg) -One of my favorite books is [Taikō](https://www.goodreads.com/book/show/336228.Taiko), it is the story about a prominent figure in the history of Japan, [Toyotomy Hideyoshi](https://www.britannica.com/biography/Toyotomi-Hideyoshi). He came from nothing, and through resilient and his wonderful mind, he has become one of the most powerful ruler in Japan's history. I enjoy his personality and the way he moved through life. +One of my favorite books is [Taikō](https://www.goodreads.com/book/show/336228.Taiko), it is the story about a prominent figure in the history of Japan, [Toyotomy Hideyoshi](https://www.britannica.com/biography/Toyotomi-Hideyoshi). He came from nothing, and through his resilience and wonderful mind, he has become one of the most powerful rulers in Japan's history. I enjoy his personality and the way he moved through life. -The color is an adaptation of **_App-Which-Must-Not-Be-Named_**'s color scheme, with an extra color (pink) to complete the flower's fifth petals. The petal layers are the same color scheme as the main layer rotating back and forth to "bring the flower to life." +The color is an adaptation of **_App-Which-Must-Not-Be-Named_**'s color scheme, with an extra color (pink) to complete the flower's fifth petal. The petal layers are the same color scheme as the main layer rotating back and forth to "bring the flower to life." -![image](https://user-images.githubusercontent.com/27055614/182044984-2ee6d1ed-c4a7-4331-8a4b-64fcde77fe1f.png) \ No newline at end of file +![image](https://user-images.githubusercontent.com/27055614/182044984-2ee6d1ed-c4a7-4331-8a4b-64fcde77fe1f.png) diff --git a/docs/docs/overview/support-the-project.md b/docs/docs/overview/support-the-project.md index ee6ef482e6..990780c23f 100644 --- a/docs/docs/overview/support-the-project.md +++ b/docs/docs/overview/support-the-project.md @@ -4,11 +4,11 @@ sidebar_position: 3 # Support the project -I've committed to this project, and I will not stop. I will keep updating the docs, adding new features, and fixing bugs. But I can't do it alone. So I need your help to give me additional motivation to keep going. +I've committed to this project, and I will not stop. I will keep updating the docs, adding new features, and fixing bugs. But I can't do it alone, so I need your help to give me additional motivation to keep going. -As our hosts in the [selfhosted.show - In the episode 'The-organization-must-not-be-name is a Hostile Actor'](https://selfhosted.show/79?t=1418) said, this is a massive undertaking of what the team and I are doing. And I would love to someday be able to do this full-time, and I am asking for your help to make that happen. +As our hosts in the [selfhosted.show - In the episode 'The-organization-must-not-be-name is a Hostile Actor'](https://selfhosted.show/79?t=1418) said, this is a massive undertaking; what the team and I are doing. I would love to someday be able to do this full-time, and I am asking for your help to make that happen. -If you feel like this is the right cause and the app is something you are seeing yourself using for a long time, please consider supporting the project with the option below. +If you feel like this is the right cause and the app is something you see yourself using for a long time, please consider supporting the project with the options below. ## Donation @@ -17,4 +17,4 @@ If you feel like this is the right cause and the app is something you are seeing ## Contribution -If you are a programmer/developer and the app's [technology stack](./technology-stack.md) is something you are familiar with, please consider contributing to the project. The team and I am always looking for new contributors. You can refer to the [contribution guildelines](/docs/contribution-guidelines) to start leaving your mark on the project. +If you are a programmer/developer and the app's [technology stack](./technology-stack.md) is something you are familiar with, please consider contributing to the project. The team and I are always looking for new contributors. You can refer to the [contribution guildelines](/docs/contribution-guidelines) to start leaving your mark on the project. diff --git a/docs/docs/usage/automatic-backup.md b/docs/docs/usage/automatic-backup.md index 50a90073be..34b8356ea7 100644 --- a/docs/docs/usage/automatic-backup.md +++ b/docs/docs/usage/automatic-backup.md @@ -18,13 +18,13 @@ On Android, there are two options for automatic backup ## Foreground backup -If foreground backup is enabled. Whenever the app is opened or resumed, it will check if any photos or videos in the selected album(s) have yet to be uploaded to the cloud (the remainder count). If there are any, it will upload them to the cloud. +If foreground backup is enabled: whenever the app is opened or resumed, it will check if any photos or videos in the selected album(s) have yet to be uploaded to the cloud (the remainder count). If there are any, they will be uploaded. ## Background backup Background backup is only available on Android thanks to the contribution effort of [@zoodyy](https://github.com/zoodyy). -If background backup is enabled. The app will periodically check if any photos or videos in the selected album(s) still need to be uploaded to the cloud. If there are any, it will upload them to the cloud in the background. +If background backup is enabled. The app will periodically check if there are any new photos or videos in the selected album(s) to be uploaded to the cloud. If there are, it will upload them to the cloud in the background. A native Android notification shows up when the background upload is in progress. You can further customize the notification by going to the app's settings. @@ -32,4 +32,4 @@ A native Android notification shows up when the background upload is in progress * The app must be in the background for the backup worker to start running. * It is a well-known problem that some Android models are very strict with battery optimization settings, which can cause a problem with the background worker. Please visit [Don't kill my app](https://dontkillmyapp.com/) for a guide on disabling this setting on your phone. * If you reopen the app and the first page you see is the backup page, the counts will reflect the background uploaded result. You have to navigate out of the page and come back to see the updated counts. -::: \ No newline at end of file +::: diff --git a/docs/docs/usage/bulk-upload.md b/docs/docs/usage/bulk-upload.md index 05889c16af..a65b17e4d3 100644 --- a/docs/docs/usage/bulk-upload.md +++ b/docs/docs/usage/bulk-upload.md @@ -4,7 +4,7 @@ sidebar_position: 3 # Bulk Upload (Using the CLI) -You can use the CLI to upload the existing gallery to the Immich's server +You can use the CLI to upload an existing gallery to the Immich server [Immich CLI Repository](https://github.com/immich-app/CLI) @@ -19,7 +19,7 @@ npm i -g immich ``` ## Quick Start -Specify user's credential, Immich's server address and port and the directory you would like to upload videos/photos from. +Specify user's credentials, Immich's server address and port, and the directory you would like to upload videos/photos from. ```bash immich upload --email testuser@email.com --password password --server http://192.168.1.216:2283/api -d your/target/directory @@ -42,7 +42,7 @@ immich upload --email testuser@email.com --password password --server http://192 ### Run via Docker -Be aware that as this runs inside a container, it mounts your current directory as a volume and for the -d flag you need to use the path inside the container. +Be aware that as this runs inside a container it mounts your current directory as a volume, and for the -d flag you need to use the path inside the container. ```bash docker run -it --rm -v $(pwd):/import ghcr.io/immich-app/immich-cli:latest upload --email testuser@email.com --password password --server http://192.168.1.216:2283/api -d /import diff --git a/docs/docs/usage/post-installation.md b/docs/docs/usage/post-installation.md index 59050426ac..95f126d8bd 100644 --- a/docs/docs/usage/post-installation.md +++ b/docs/docs/usage/post-installation.md @@ -14,7 +14,7 @@ The mobile app can be downloaded from - [Apple App Store](https://apps.apple.com/us/app/immich/id1613945652) - [F-Droid](https://f-droid.org/packages/app.alextran.immich) -## Step 2 - Registering the admin user +## Step 2 - Register the admin user The first user to register will be the admin user. The admin user will be able to add other users to the application. @@ -24,7 +24,7 @@ To register for the admin user, access the web application at `http:// -You can select the album you want to back up from the backup screen to the Immich server. +You can select which album(s) you want to back up to the Immich server from the backup screen. @@ -54,4 +54,4 @@ You can also enable auto foreground or background backup (only on Android). For :::tip Application Mechanism #### [Foreground and background backup](/docs/usage/automatic-backup) #### [Bulk upload (using the CLI)](/docs/usage/bulk-upload) -::: \ No newline at end of file +::: diff --git a/docs/docs/usage/update.md b/docs/docs/usage/update.md index b5ea57f3a7..3a1b2bda46 100644 --- a/docs/docs/usage/update.md +++ b/docs/docs/usage/update.md @@ -4,8 +4,8 @@ sidebar_position: 4 # Update the application -If you are using Docker Compose, to update the application use the following commands in the directory where the `docker-compose.yml` file is located: +If you are using Docker Compose, update the application use the following commands in the directory where the `docker-compose.yml` file is located: ```bash title="Update Immich" docker-compose pull && docker-compose up -d # Or `docker compose` -``` \ No newline at end of file +```