Restructure --help and Options section in README
This commit is contained in:
Alexander Graf
parent
58c12d5618
commit
7198f1ad9f
105
README.rst
105
README.rst
@ -99,37 +99,82 @@ Advanced Options
|
|||||||
The following flags can be given to Instaloader to specify how profiles should
|
The following flags can be given to Instaloader to specify how profiles should
|
||||||
be downloaded.
|
be downloaded.
|
||||||
|
|
||||||
--fast-update Stop when encountering the first already-downloaded post
|
To get a list of all flags, their abbreviations and their descriptions, you may
|
||||||
of a profile.
|
run ``instaloader --help``.
|
||||||
--profile-pic-only Only download profile pictures. Without this flag, the current
|
|
||||||
profile picture and all the profile's posts are downloaded.
|
|
||||||
--skip-videos Skip posts which are videos.
|
|
||||||
--geotags Also **download geotags** and store Google Maps links in
|
|
||||||
separate textfiles.
|
|
||||||
--count COUNT If used with ``#hashtag``, ``:feed-all`` or
|
|
||||||
``:feed-liked``: Do not attempt to download more than COUNT
|
|
||||||
posts.
|
|
||||||
--quiet Do not output any messages except warnings and errors. This
|
|
||||||
option makes Instaloader **suitable as a cron job**.
|
|
||||||
--no-sleep Normally, Instaloader waits a few seconds between requests
|
|
||||||
to the Instagram servers. This flag inhibits this behavior.
|
|
||||||
--password PASSWORD If used with ``--login``, use parameter as password if no
|
|
||||||
valid session file is found, instead of asking
|
|
||||||
interactively.
|
|
||||||
--sessionfile FILE Specify an alternative place for loading and storing the
|
|
||||||
session cookies. Without this flag, they are stored in a path
|
|
||||||
within your temporary directory, encoding your local
|
|
||||||
username and your instagram profile name.
|
|
||||||
--no-profile-subdir Instead of creating a subdirectory for each profile and
|
|
||||||
storing pictures there, store pictures in files named
|
|
||||||
'PROFILE__DATE_TIME.jpg.'
|
|
||||||
--hashtag-username When downloading by #hashtag, lookup the picture's username
|
|
||||||
to decide in which directory to store, rather than storing
|
|
||||||
all pictures in directory '#hashtag'.
|
|
||||||
--user-agent STRING Change User Agent for HTTP requests to STRING, rather than
|
|
||||||
our default user agent (Chrome 51).
|
|
||||||
|
|
||||||
To get a list of all flags, run ``instaloader --help``.
|
What to Download
|
||||||
|
^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
Specify a list of profiles or #hashtags. For each of these, Instaloader
|
||||||
|
downloads all posts along with the pictures's captions and the current
|
||||||
|
**profile picture**.
|
||||||
|
|
||||||
|
--profile-pic-only Only download profile picture.
|
||||||
|
--skip-videos Do not download videos.
|
||||||
|
--geotags **Download geotags** when available. Geotags are stored as
|
||||||
|
a text file with the location's name and a Google Maps
|
||||||
|
link. This requires an additional request to the
|
||||||
|
Instagram server for each picture, which is why it is
|
||||||
|
disabled by default.
|
||||||
|
|
||||||
|
When to Stop Downloading
|
||||||
|
^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
If none of these options are given, Instaloader goes through all pictures
|
||||||
|
matching the specified targets.
|
||||||
|
|
||||||
|
--fast-update For each target, stop when encountering the first
|
||||||
|
already-downloaded picture. This flag is recommended
|
||||||
|
when you use Instaloader to update your personal
|
||||||
|
Instagram archive.
|
||||||
|
--count COUNT Do not attempt to download more than COUNT posts.
|
||||||
|
Applies only to ``#hashtag``, ``:feed-all`` and ``:feed-liked``.
|
||||||
|
|
||||||
|
|
||||||
|
Login (Download Private Profiles)
|
||||||
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
Instaloader can **login to Instagram**. This allows downloading private
|
||||||
|
profiles and automatically **finding profiles by their ID** if they have been
|
||||||
|
renamed. To login, pass the ``--login`` option. Your session cookie (not your
|
||||||
|
password!) will be saved to a local file to be reused next time you want
|
||||||
|
Instaloader to login.
|
||||||
|
|
||||||
|
--login YOUR-USERNAME Login name (profile name) for your Instagram account.
|
||||||
|
--sessionfile SESSIONFILE Path for loading and storing session key file.
|
||||||
|
Defaults to a path
|
||||||
|
within your temporary directory, encoding your local
|
||||||
|
username and your Instagram profile name.
|
||||||
|
--password YOUR-PASSWORD Password for your Instagram account. Without this
|
||||||
|
option, you'll be prompted for your password
|
||||||
|
interactively if there is not yet a valid session
|
||||||
|
file.
|
||||||
|
|
||||||
|
How to Download
|
||||||
|
^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
--no-profile-subdir Instead of creating a subdirectory for each profile
|
||||||
|
and storing pictures there, store pictures in files
|
||||||
|
named ``PROFILE__DATE_TIME.jpg``.
|
||||||
|
--hashtag-username Lookup username of pictures when downloading by
|
||||||
|
#hashtag and encode it in the downlaoded file's path
|
||||||
|
or filename (if ``--no-profile-subdir``). Without this
|
||||||
|
option, the #hashtag is used instead. This requires an
|
||||||
|
additional request to the Instagram server for each
|
||||||
|
picture, which is why it is disabled by default.
|
||||||
|
--user-agent USER_AGENT User Agent to use for HTTP requests. Per default,
|
||||||
|
Instaloader pretends being Chrome/51.
|
||||||
|
--no-sleep Do not sleep between requests to Instagram's servers.
|
||||||
|
This makes downloading faster, but may be suspicious.
|
||||||
|
|
||||||
|
Miscellaneous Options
|
||||||
|
^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
--shorter-output Do not display captions while downloading.
|
||||||
|
--quiet Disable user interaction, i.e. do not print messages
|
||||||
|
(except errors) and fail if login credentials are
|
||||||
|
needed but not given. This makes Instaloader
|
||||||
|
**suitable as a cron job**.
|
||||||
|
|
||||||
Usage as Python module
|
Usage as Python module
|
||||||
----------------------
|
----------------------
|
||||||
|
|||||||
113
instaloader.py
113
instaloader.py
@ -1,7 +1,6 @@
|
|||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
|
|
||||||
"""Tool to download pictures (or videos) and captions from Instagram, from a given set
|
"""Download pictures (or videos) along with their captions and other metadata from Instagram."""
|
||||||
of profiles (even if private), from your feed or from all followees of a given profile."""
|
|
||||||
|
|
||||||
import datetime
|
import datetime
|
||||||
import getpass
|
import getpass
|
||||||
@ -869,61 +868,85 @@ class Instaloader:
|
|||||||
|
|
||||||
|
|
||||||
def main():
|
def main():
|
||||||
parser = ArgumentParser(description=__doc__,
|
parser = ArgumentParser(description=__doc__, add_help=False,
|
||||||
epilog="Report issues at https://github.com/Thammus/instaloader/issues.")
|
epilog="Report issues at https://github.com/Thammus/instaloader/issues.")
|
||||||
parser.add_argument('profile', nargs='*', metavar='profile|#hashtag',
|
|
||||||
|
g_what = parser.add_argument_group('What to Download',
|
||||||
|
'Specify a list of profiles or #hashtags. For each of these, Instaloader '
|
||||||
|
'downloads all posts along with the pictures\'s '
|
||||||
|
'captions and the current profile picture.')
|
||||||
|
g_what.add_argument('profile', nargs='*', metavar='profile|#hashtag',
|
||||||
help='Name of profile or #hashtag to download. '
|
help='Name of profile or #hashtag to download. '
|
||||||
'Alternatively, if --login is given: @<profile> to download all followees of '
|
'Alternatively, if --login is given: @<profile> to download all followees of '
|
||||||
'<profile>; or the special targets :feed-all or :feed-liked to '
|
'<profile>; or the special targets :feed-all or :feed-liked to '
|
||||||
'download pictures from your feed (using '
|
'download pictures from your feed (using '
|
||||||
'--fast-update is recommended).')
|
'--fast-update is recommended).')
|
||||||
parser.add_argument('--version', action='version',
|
g_what.add_argument('-P', '--profile-pic-only', action='store_true',
|
||||||
version=__version__)
|
help='Only download profile picture.')
|
||||||
parser.add_argument('-l', '--login', metavar='YOUR-USERNAME',
|
g_what.add_argument('-V', '--skip-videos', action='store_true',
|
||||||
help='Login name for your Instagram account. Not needed to download public '
|
help='Do not download videos.')
|
||||||
'profiles, but if you want to download private profiles or all followees of '
|
g_what.add_argument('-G', '--geotags', action='store_true',
|
||||||
'some profile, you have to specify a username used to login.')
|
help='Download geotags when available. Geotags are stored as a '
|
||||||
parser.add_argument('-p', '--password', metavar='YOUR-PASSWORD',
|
'text file with the location\'s name and a Google Maps link. '
|
||||||
help='Note that specifying passwords on command line is considered insecure! '
|
'This requires an additional request to the Instagram '
|
||||||
'Password for your Instagram account. If --login is given and there is '
|
|
||||||
'not yet a valid session file, you\'ll be prompted for your password if '
|
|
||||||
'--password is not given. Specifying this option without --login has no '
|
|
||||||
'effect.')
|
|
||||||
parser.add_argument('-f', '--sessionfile',
|
|
||||||
help='File to store session key, defaults to ' + get_default_session_filename("<login_name>"))
|
|
||||||
parser.add_argument('-P', '--profile-pic-only', action='store_true',
|
|
||||||
help='Only download profile picture')
|
|
||||||
parser.add_argument('-V', '--skip-videos', action='store_true',
|
|
||||||
help='Do not download videos')
|
|
||||||
parser.add_argument('-G', '--geotags', action='store_true',
|
|
||||||
help='Store geotags when available. This requires an additional request to the Instagram '
|
|
||||||
'server for each picture, which is why it is disabled by default.')
|
'server for each picture, which is why it is disabled by default.')
|
||||||
parser.add_argument('-F', '--fast-update', action='store_true',
|
|
||||||
help='Abort at encounter of first already-downloaded picture')
|
g_stop = parser.add_argument_group('When to Stop Downloading',
|
||||||
parser.add_argument('-c', '--count',
|
'If none of these options are given, Instaloader goes through all pictures '
|
||||||
|
'matching the specified targets.')
|
||||||
|
g_stop.add_argument('-F', '--fast-update', action='store_true',
|
||||||
|
help='For each target, stop when encountering the first already-downloaded picture. This '
|
||||||
|
'flag is recommended when you use Instaloader to update your personal Instagram archive.')
|
||||||
|
g_stop.add_argument('-c', '--count',
|
||||||
help='Do not attempt to download more than COUNT posts. '
|
help='Do not attempt to download more than COUNT posts. '
|
||||||
'Applies only to #hashtag, :feed-all and :feed-liked.')
|
'Applies only to #hashtag, :feed-all and :feed-liked.')
|
||||||
parser.add_argument('--no-profile-subdir', action='store_true',
|
|
||||||
help='Instead of creating a subdirectory for each profile and storing pictures there, store '
|
g_login = parser.add_argument_group('Login (Download Private Profiles)',
|
||||||
'pictures in files named PROFILE__DATE_TIME.jpg.')
|
'Instaloader can login to Instagram. This allows downloading private profiles '
|
||||||
parser.add_argument('--hashtag-username', action='store_true',
|
'and automatically finding profiles by their ID if they have been renamed. '
|
||||||
help='Lookup username of pictures when downloading by #hashtag and encode it in the downlaoded '
|
'To login, pass the --login option. Your session cookie (not your password!) '
|
||||||
'file\'s path or filename (if --no-profile-subdir). Without this option, the #hashtag is '
|
'will be saved to a local file to be reused next time you want Instaloader '
|
||||||
'used instead. This requires an additional request to the Instagram server for each '
|
'to login.')
|
||||||
'picture, which is why it is disabled by default.')
|
g_login.add_argument('-l', '--login', metavar='YOUR-USERNAME',
|
||||||
parser.add_argument('--user-agent',
|
help='Login name (profile name) for your Instagram account.')
|
||||||
help='User Agent to use for HTTP requests. Defaults to \'{}\'.'.format(default_user_agent()))
|
g_login.add_argument('-f', '--sessionfile',
|
||||||
parser.add_argument('-S', '--no-sleep', action='store_true',
|
help='Path for loading and storing session key file. '
|
||||||
help='Do not sleep between actual downloads of pictures')
|
'Defaults to ' + get_default_session_filename("<login_name>"))
|
||||||
parser.add_argument('-O', '--shorter-output', action='store_true',
|
g_login.add_argument('-p', '--password', metavar='YOUR-PASSWORD',
|
||||||
help='Do not display captions while downloading')
|
help='Password for your Instagram account. Without this option, '
|
||||||
parser.add_argument('-q', '--quiet', action='store_true',
|
'you\'ll be prompted for your password interactively if '
|
||||||
|
'there is not yet a valid session file.')
|
||||||
|
|
||||||
|
g_how = parser.add_argument_group('How to Download')
|
||||||
|
g_how.add_argument('--no-profile-subdir', action='store_true',
|
||||||
|
help='Instead of creating a subdirectory for each profile and storing pictures there, store '
|
||||||
|
'pictures in files named PROFILE__DATE_TIME.jpg.')
|
||||||
|
g_how.add_argument('--hashtag-username', action='store_true',
|
||||||
|
help='Lookup username of pictures when downloading by #hashtag and encode it in the downlaoded '
|
||||||
|
'file\'s path or filename (if --no-profile-subdir). Without this option, the #hashtag is '
|
||||||
|
'used instead. This requires an additional request to the Instagram server for each '
|
||||||
|
'picture, which is why it is disabled by default.')
|
||||||
|
g_how.add_argument('--user-agent',
|
||||||
|
help='User Agent to use for HTTP requests. Defaults to \'{}\'.'.format(default_user_agent()))
|
||||||
|
g_how.add_argument('-S', '--no-sleep', action='store_true',
|
||||||
|
help='Do not sleep between requests to Instagram\'s servers. This makes downloading faster, but '
|
||||||
|
'may be suspicious.')
|
||||||
|
|
||||||
|
g_misc = parser.add_argument_group('Miscellaneous Options')
|
||||||
|
g_misc.add_argument('-O', '--shorter-output', action='store_true',
|
||||||
|
help='Do not display captions while downloading.')
|
||||||
|
g_misc.add_argument('-q', '--quiet', action='store_true',
|
||||||
help='Disable user interaction, i.e. do not print messages (except errors) and fail '
|
help='Disable user interaction, i.e. do not print messages (except errors) and fail '
|
||||||
'if login credentials are needed but not given.')
|
'if login credentials are needed but not given. This makes Instaloader suitable as a '
|
||||||
|
'cron job.')
|
||||||
|
g_misc.add_argument('-h', '--help', action='help', help='Show this help message and exit.')
|
||||||
|
g_misc.add_argument('--version', action='version', help='Show version number and exit.',
|
||||||
|
version=__version__)
|
||||||
|
|
||||||
args = parser.parse_args()
|
args = parser.parse_args()
|
||||||
try:
|
try:
|
||||||
loader = Instaloader(sleep = not args.no_sleep, quiet = args.quiet, shorter_output = args.shorter_output,
|
loader = Instaloader(sleep=not args.no_sleep, quiet=args.quiet, shorter_output=args.shorter_output,
|
||||||
profile_subdirs = not args.no_profile_subdir, user_agent = args.user_agent)
|
profile_subdirs=not args.no_profile_subdir, user_agent=args.user_agent)
|
||||||
loader.download_profiles(args.profile, args.login, args.password, args.sessionfile,
|
loader.download_profiles(args.profile, args.login, args.password, args.sessionfile,
|
||||||
int(args.count) if args.count is not None else None,
|
int(args.count) if args.count is not None else None,
|
||||||
args.profile_pic_only, not args.skip_videos, args.geotags, args.fast_update,
|
args.profile_pic_only, not args.skip_videos, args.geotags, args.fast_update,
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user