use help as default cli option (#965)

CHANGELOG.md

@@ -2,7 +2,8 @@
 
 ## Unreleased
 
-- fix: force_size should not skip subsequent sizes [ref](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/955)
+- feature: when ran without parameters, `icloudpd` shows help [#963](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/963)
+- fix: force_size should not skip subsequent sizes [#955](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/955)
 
 ## 1.23.4 (2024-09-02)
 

docs/install.md

@@ -1,7 +1,12 @@
 # Install and Run
 
 There are three ways to run `icloudpd`:
-1. Download executable for your platform from the GitHub [Release](https://github.com/icloud-photos-downloader/icloud_photos_downloader/releases/tag/v1.23.4) and run it
+1. Download executable for your platform from the GitHub [Release](https://github.com/icloud-photos-downloader/icloud_photos_downloader/releases/tag/v1.23.4) and run it, e.g.:
+
+    ```sh
+    icloudpd --username [email protected] --directory photos --watch-with-interval 3600
+    ```
+
 1. Use package manager to install, update, and, in some cases, run ([Docker](#docker), [PyPI](#pypi), [AUR](#aur), [npm](#npm))
 1. Build and run from the source
 

src/icloudpd/base.py

@@ -282,8 +282,7 @@ def report_version(ctx: click.Context, _param: click.Parameter, value: bool) ->
 CONTEXT_SETTINGS = {"help_option_names": ["-h", "--help"]}
 
 
-@click.command(context_settings=CONTEXT_SETTINGS, options_metavar="<options>")
-# @click.argument(
+@click.command(context_settings=CONTEXT_SETTINGS, options_metavar="<options>", no_args_is_help=True)
 @click.option(
     "-d",
     "--directory",