Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stevenlafl/threads-web-client
A web client for Meta's new Threads app
https://github.com/stevenlafl/threads-web-client
instagram instagram-threads meta nextjs node threads threadsjs web
Last synced: about 2 months ago
JSON representation
A web client for Meta's new Threads app
- Host: GitHub
- URL: https://github.com/stevenlafl/threads-web-client
- Owner: stevenlafl
- License: gpl-3.0
- Created: 2023-07-10T03:28:15.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2023-07-19T03:46:28.000Z (about 1 year ago)
- Last Synced: 2024-06-27T07:35:01.868Z (3 months ago)
- Topics: instagram, instagram-threads, meta, nextjs, node, threads, threadsjs, web
- Language: TypeScript
- Homepage:
- Size: 550 KB
- Stars: 40
- Watchers: 2
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Instagram Threads Web Client
[](https://hub.docker.com/r/stevenlafl/threads-web-client/)
[](http://isitmaintained.com/project/stevenlafl/threads-web-client "Average time to resolve an issue")
This project provides a desktop web client for Threads. Meta is too slow to implement, so I'm working on it. Mobile is not the best experience to work with.
##### DISCLAIMER: This software is made without any support from Meta and is in no way related to the company or any of its developers. This client makes the experience similar to Twitter but it is much different in implementation (original is in bootstrap while this one uses Tailwind, with different iconography). Use of the GPLv3 license is a notice of intent that there be no financial reward for an end-resulting usage or implementation of this software - it is simply a hobby project, though personal donations to its contributors are welcome.
##### NOTICE: Instagram's Threads API is undocumented so we cannot guarantee that you will not be suspended using this client.
Please see [LICENSE](https://github.com/stevenlafl/threads-web-client/blob/master/LICENSE) for a notice of non-warranty and non-liability.
## Running
```
docker run -it -p 3000:3000 stevenlafl/threads-web-client:latest
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
Now you are presented with a login screen. This login screen **only exchanges a username/password combination for a token** and stores it on your browser in localStorage along with the application state. Subsequent requests use that localStorage's token value to do everything. This has no backend storage, so any browser session will work perfectly fine. I run the one instance and have multiple people accessing it for their feeds.
You'll be presented a page like this:
Enter your credentials. Then you will have access to the client. Here are some screenshots (click to view larger version):
## Contributing
First, run the development server:
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
```
Then it's the same steps as above, minus the docker portion. Everything should behave like a standard NextJS project.
## Roadmap
Right now this just displays the regular feed with likes and reply counts. It displays images and it displays video properly.
Todo:
1. ~~View threads~~
2. ~~View replies~~
3. ~~Add posting~~
4. ~~Add replying~~
5. ~~View images~~
6. ~~View videos~~
7. ~~View quotes~~
5. ~~View repost~~
6. ~~Add liking~~
7. ~~Add reposting~~
8. Add quote posting
9. Add account switching
10. ~~Follow/unfollow~~
11. ~~Mute/Unmute~~
12. ~~Block/unblock~~
13. ~~Emoji picker~~
14. ~~User search~~
15. ~~Recommended users sidebar~~
16. Optimized/pretty post formatting
17. Character limiter on text entry for posting
18. ???
### Credits
Uses [NextJS](https://github.com/vercel/next.js/) and [threads.js](https://github.com/threadsjs/threads.js) at the core
For the frontend tailwind work, this great UI by @hiravesonali
https://tailwindcomponents.com/component/twitter-clone