mirror of
https://github.com/instaloader/instaloader.git
synced 2024-08-18 12:49:38 +02:00
add LICENSE and README.md
This commit is contained in:
parent
e464787772
commit
5adbee2273
21
LICENSE
Normal file
21
LICENSE
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) 2016 Alexander Graf and André Koch-Kramer.
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
60
README.md
Normal file
60
README.md
Normal file
@ -0,0 +1,60 @@
|
|||||||
|
# instaloader
|
||||||
|
|
||||||
|
Simple downloader to fetch all Instagram pictures and captions from a given profile.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Ensure having [Python](https://www.python.org/) (at least version 3.3) and
|
||||||
|
[python3-requests](https://pypi.python.org/pypi/requests/) installed.
|
||||||
|
|
||||||
|
After having downloaded instaloader.py, you invoke it with
|
||||||
|
```
|
||||||
|
instaloader.py profile [profile ...]
|
||||||
|
```
|
||||||
|
where `profile` is the name of a profile you want to download. Instead of only one profile, you may
|
||||||
|
also specify a list of profiles.
|
||||||
|
|
||||||
|
To later update your local copy of that profile, you may run
|
||||||
|
```
|
||||||
|
instaloader.py --fast-update profile [profile ...]
|
||||||
|
```
|
||||||
|
When `--fast-update` is given, instaloder terminates when arriving at the first already-downloaded
|
||||||
|
picture.
|
||||||
|
|
||||||
|
Instaloader can also be used to **download private profiles**. To do so, invoke it with
|
||||||
|
```
|
||||||
|
instaloader.py --login username profile [profile ...]
|
||||||
|
```
|
||||||
|
When invoked like this, it also **stores the session cookies** in a file in `/tmp`, which will later
|
||||||
|
be reused when `--login` is given. So you can download private profiles **non-interactively** when
|
||||||
|
you already have a valid session cookies file.
|
||||||
|
|
||||||
|
The `--quiet` option makes it also **suitable as a cron job**.
|
||||||
|
|
||||||
|
To get a list of other helpful flags, run `instaloader.py --help`.
|
||||||
|
|
||||||
|
## Usage as library
|
||||||
|
|
||||||
|
You may also use parts of instaloader as library to do other interesting things.
|
||||||
|
|
||||||
|
For example, to get a list of all followers of a profile as well as their follower count, do
|
||||||
|
```python
|
||||||
|
import instaloader
|
||||||
|
|
||||||
|
# login
|
||||||
|
session = instaloader.get_logged_in_session(USERNAME)
|
||||||
|
|
||||||
|
# get followees
|
||||||
|
followees = instaloader.get_followees(PROFILES, session)
|
||||||
|
for f in followees:
|
||||||
|
print("%i\t%s\t%s" % (f['follower_count'], f['username'], f['full_name']))
|
||||||
|
```
|
||||||
|
|
||||||
|
Then, you may download all pictures of all followees with
|
||||||
|
```python
|
||||||
|
for f in followees:
|
||||||
|
try:
|
||||||
|
instaloader.download(f['username'], session)
|
||||||
|
except instaloader.NonfatalException:
|
||||||
|
pass
|
||||||
|
```
|
Loading…
Reference in New Issue
Block a user