barinsta/README.md

56 lines
4.1 KiB
Markdown
Raw Normal View History

2020-07-01 22:55:53 +02:00
<img src="./app/play_icon.png" alt="InstaGrabber" align="right" width="25%"/>
2020-07-01 19:08:28 +02:00
2020-07-01 22:55:53 +02:00
## InstaGrabber
2020-07-01 19:08:28 +02:00
2020-07-22 02:50:43 +02:00
InstaGrabber is an app that allows...
2020-07-01 22:55:53 +02:00
2020-07-22 02:50:43 +02:00
* Viewing **and downloading** Instagram posts, stories (including highlights)\*, DM\*, and profile pictures, **without** letting people know you viewed it<sup>1</sup>! Works for followed private accounts\*!
* Downloading multiple posts at once (hold & select)!
* **Copy** post captions, comments, DM messages\*, and profile bios.
* **Compare** follower/following list<sup>2</sup>!
* Searching usernames and hashtags.
<sub>* Requires [login](#how-to-log-in). You must be a current follower of the desired private accounts, this app cannot hack people (which I have to state despite the obvious)!</sub>
It can be used as a drop-in replacement for read functionalities of the official Instagram app, with unnecessary components stripped.
[![Open Source Love svg3](https://badges.frapsoft.com/os/v3/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[![GPLv3 license](https://img.shields.io/badge/License-GPLv3-blue.svg)](./LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/austinhuang0131/instagrabber.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/austinhuang0131/instagrabber/stargazers/)
This app is originally made by [@AwaisKing](https://github.com/AwaisKing) who posted on [GitLab](https://gitlab.com/AwaisKing/instagrabber) but subsequently abandoned it. I decided to continue the app cuz why not, ~~even though it might not be that *cash money*.~~ (Also I need to learn Java.)
2020-07-01 22:55:53 +02:00
### Download
2020-07-17 02:58:11 +02:00
Download [here](https://github.com/austinhuang0131/instagrabber/releases). Under each release is an `app-release.apk`. Just install that. Unfortunately, I have to sign it with my own key, which means you have to uninstall the old app and log in again. Sorry.
2020-07-01 22:55:53 +02:00
2020-07-22 02:54:15 +02:00
I will release it on F-droid somewhen later.
2020-07-01 22:55:53 +02:00
### How to log in
2020-07-20 17:49:32 +02:00
By logging in, you can access posts/stories from private accounts, as well as your direct messages.
The relevant source code is [here](https://github.com/austinhuang0131/instagrabber/blob/master/app/src/main/java/awais/instagrabber/activities/Login.java) should you be concerned.
1. Click the 3 dots on the bottom right corner.
2. Click "Settings".
3. Scroll down, click the green button called "Login".
4. (Recommended, not required) Enable desktop mode if you have 2FA.
5. Login as usual. Use "Refresh" when needed.
6. When you see your feed page, click "Get cookies".
7. Test it by checking your direct messages. If it loads, it works!
### Legal
* We do not collect any data, other than crash log, which is only stored locally. No funky stuff.
* You can voluntarily provide us with the crash log (3 dots => Settings => "Send logs"). In that case, it is your sole responsibility to remove any sensitive information. As well, you agree to the privacy policy of the platform that you send it on.
2020-07-22 02:50:43 +02:00
* While the best effort is made in this app, nobody (me or AWAiS) is liable for damages that have arisen due to the usage of this app, including but not limited to account bans and broken friendship. (The former wouldn't happen so easily as this app does imitate actual Instagram clients, the latter depends on who is using it and who their friends are, neither of which I have any control of.)
* Please use downloaded content legally and responsibly. [Don't pull a Newsweek!](https://arstechnica.com/tech-policy/2020/06/instagram-just-threw-users-of-its-embedding-api-under-the-bus/)
* This app is licensed under GPLv3. See [LICENSE](./LICENSE).
[![forthebadge](https://forthebadge.com/images/badges/made-with-java.svg)](https://forthebadge.com)[![forthebadge](https://forthebadge.com/images/badges/built-for-android.svg)](https://forthebadge.com)
<sub>Previous owner left a lot of swearings in the code, I will remove them when I get to that file.</sub>
<sub>1. The downside is that they'll always be "new" in other Instagram clients. Also, this app will not respect DM message restrictions (replay once / no replay).<br>2. Shameless plug: If you do not have an Android device but wants to do that, read [this](https://austinhuang.me/instagram-compare).</sub>