Instagular is a custom web client for Instagram, aiming for a better desktop experience, unlike the mobile-on-web design that the official site has, while adding extra features not found on regular Instagram.
This project implements its own backend API server using a custom fork of instagram-private-api to connect/interface to Instagram, acting as a middleware between the Instagular client and the Instagram server.
The app is fully compatible with Instagram routing structure, so it's possible to replace the domain with Instagular's and continue navigating right away.
While the app should be safe to use in general (I personally use it myself), there's still the possibility for the user account to get blocked if too many actions/requests are made in a short period of time, or if a feature is not implemented correctly. Therefore, I won't take responsability for any damages caused to your account, so use at your own risk.
⚠️ Warning: Avoid comments creation for now (or use at your own risk) until further testing is done. Is possible that the comments are treated as spam by default. I lost some test accounts due to spam, and this could've been the cause, among others. I already implemented a potential solution to this problem, but can't risk more accounts just for this. If you can confirm that it works fine, let me know.
- Login/logout with persistent session on local storage.
- Feeds with auto pagination management.
- Fullscreen media viewer, with high quality photos and videos play.
- Profile user pages (posts, reels, videos, tagged).
- Stories/highlights support.
- User interaction (like/unlike, follow/unfollow, comments).
- High/original quality media download.
- Saved collections management.
- Users search engine.
Planned features:
- Stories interaction.
- Direct messaging.
- Activity/notifications.
- Quality of life options (dark mode, accesibility, etc.)
For now, Instagular is only runnable locally, but eventually, when it reaches a fully-featured state, it'll be available online, as well as a dedicated desktop app.
Install both server and client dependencies by running npm install
in the root and src/api
directories. Then, just run the API backend server with runapi
and then the app client with runapp
if you're on Linux, or run npm run dev
under the server directory and npm run start
on root for the client on Windows.
⚠️ Important Note: Since the app is fully dependant on the private api library, which is actively being developed in tandem, make sure to always keep it updated, otherwise unsupported features will break the client functionality.
Instagular is not affiliated with, authorized or endorsed in any way by Instagram, Meta, or any of its affiliates or subsidiaries.
This program exclusively works within the scope of the original service provided, therefore is designed to prohibit any abusive practice that could compromise it. Any modification and/or misuse of this program will be entirely in the user's responsability.
For legal concerns, please get in contact with the repository owner.