# Imgram
Imgram is a Python CLI for downloading Instagram posts.
## Installation
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install Imgram.
```bash
pip install imgram
```
## Usage
Sometimes URLs contain an `&`. When that's the case, you must encase the URL with `"`. The same goes for paths with spaces in them.
Anything prefixed by `?` can remain without issue
### Downloading a post to the current folder
```console
imgram URL
```
#### example:
```console
imgram https://www.instagram.com/p/DNksmWBvT0H
```
### Downloading a post to a specified folder
```console
imgram URL -o "path/to/folder"
imgram URL --output "path/to/folder"
```
#### examples:
```console
imgram https://www.instagram.com/p/DKeGhXcvPL6/?img_index=1 -o C:/Users/USER/Downloads/
imgram https://www.instagram.com/reel/DNYWdfmvHUq/?utm_source=ig_web_copy_link --output C:/Users/USER/Downloads/
```
## Contributing
Pull requests are welcome. For major changes, please open an issue first
to discuss what you would like to change.
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": null,
"name": "imgram",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "Instagram, IG, Instagram download, download, instagram post, social media",
"author": "Doozy",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/30/ec/6f04c15b6a1309993f5c559c944720f32cf2adc726d8ef3ada0c9de4f5bc/imgram-1.0.1.tar.gz",
"platform": null,
"description": "# Imgram\n\nImgram is a Python CLI for downloading Instagram posts.\n\n## Installation\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install Imgram.\n\n```bash\npip install imgram\n```\n\n## Usage\nSometimes URLs contain an `&`. When that's the case, you must encase the URL with `\"`. The same goes for paths with spaces in them. \nAnything prefixed by `?` can remain without issue\n\n### Downloading a post to the current folder\n```console\nimgram URL\n```\n#### example:\n```console\nimgram https://www.instagram.com/p/DNksmWBvT0H\n```\n\n### Downloading a post to a specified folder\n```console\nimgram URL -o \"path/to/folder\"\nimgram URL --output \"path/to/folder\"\n```\n#### examples:\n```console\nimgram https://www.instagram.com/p/DKeGhXcvPL6/?img_index=1 -o C:/Users/USER/Downloads/\nimgram https://www.instagram.com/reel/DNYWdfmvHUq/?utm_source=ig_web_copy_link --output C:/Users/USER/Downloads/\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first\nto discuss what you would like to change.\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Instagram media downloader CLI (doesn't work for stories)",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/d00zylive/Imgram/tree/master",
"Issues": "https://github.com/d00zylive/Imgram/issues",
"Repository": "https://github.com/d00zylive/Imgram.git"
},
"split_keywords": [
"instagram",
" ig",
" instagram download",
" download",
" instagram post",
" social media"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "01c0f51eb19dd82a6ecbe38e467704b18521d403f9bfba630a8954041a0d8696",
"md5": "67933d90627b37451c9e08dba4c5ffb8",
"sha256": "0314a0bd482870c2d118a08a5742546aa0a5193b37b7dc00380addc5a791c0a1"
},
"downloads": -1,
"filename": "imgram-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "67933d90627b37451c9e08dba4c5ffb8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 4059,
"upload_time": "2025-08-21T20:41:28",
"upload_time_iso_8601": "2025-08-21T20:41:28.987426Z",
"url": "https://files.pythonhosted.org/packages/01/c0/f51eb19dd82a6ecbe38e467704b18521d403f9bfba630a8954041a0d8696/imgram-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "30ec6f04c15b6a1309993f5c559c944720f32cf2adc726d8ef3ada0c9de4f5bc",
"md5": "61fccabb91d1cb4985b0a4176479d6cd",
"sha256": "3a8ac840127eec3eaea770239254a7adbfcc703019235873832b8ffcd1baa060"
},
"downloads": -1,
"filename": "imgram-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "61fccabb91d1cb4985b0a4176479d6cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 3326,
"upload_time": "2025-08-21T20:41:29",
"upload_time_iso_8601": "2025-08-21T20:41:29.959076Z",
"url": "https://files.pythonhosted.org/packages/30/ec/6f04c15b6a1309993f5c559c944720f32cf2adc726d8ef3ada0c9de4f5bc/imgram-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-21 20:41:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "d00zylive",
"github_project": "Imgram",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "imgram"
}