https://github.com/mamantoha/twitter-account-location
A browser extension that displays account-based location information next to Twitter/X usernames.
https://github.com/mamantoha/twitter-account-location
chrome chrome-extension firefox firefox-addon twitter webextension
Last synced: 5 months ago
JSON representation
A browser extension that displays account-based location information next to Twitter/X usernames.
- Host: GitHub
- URL: https://github.com/mamantoha/twitter-account-location
- Owner: mamantoha
- License: mit
- Created: 2025-11-28T14:29:42.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-23T13:52:07.000Z (6 months ago)
- Last Synced: 2026-01-13T19:48:59.055Z (5 months ago)
- Topics: chrome, chrome-extension, firefox, firefox-addon, twitter, webextension
- Language: JavaScript
- Homepage:
- Size: 573 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Twitter Account Location
A browser extension that displays account-based location information next to Twitter/X usernames.
[](https://addons.mozilla.org/uk/firefox/addon/twitter-account-location/)
[](https://chromewebstore.google.com/detail/twitter-account-location/mhfejoclbhjgkhmlapfhgpepdmnmanhi)
[](https://github.com/mamantoha/twitter-account-location/releases)
[](https://github.com/mamantoha/twitter-account-location/blob/main/LICENSE)
## Features
- Detects usernames on Twitter/X pages
- Queries Twitter's GraphQL API for location info
- Displays location next to usernames
- Works with infinite scroll
- Caches location data for 30 days
## Installation
| Browser | Method | Link |
|----------|-----------------------|----------------------------------------------------------------------|
| Firefox | Add-on Store | [Firefox Add-ons](https://addons.mozilla.org/uk/firefox/addon/twitter-account-location/) |
| Chrome | Web Store | [Chrome Web Store](https://chromewebstore.google.com/detail/twitter-account-location/mhfejoclbhjgkhmlapfhgpepdmnmanhi) |
| Both | Manual (ZIP) | [GitHub Releases](https://github.com/mamantoha/twitter-account-location/releases) |
### Manual Installation
1. Clone or download this repository.
2. Follow the browser-specific steps below:
#### Firefox
- In Firefox, open `about:debugging#/runtime/this-firefox`.
- Click **Load Temporary Add-on...** and select the `manifest.json` file from this repository (or any file inside the extension directory).
- The extension will be loaded temporarily and will remain active until Firefox is restarted.
#### Chrome
- In Chrome, go to `chrome://extensions/`.
- Enable **Developer mode** (toggle in the top right).
- Drag and drop the downloaded ZIP file onto the extensions page.
- The extension will be installed and appear in your Chrome extensions list.
- To update, remove the old version and repeat these steps with the new ZIP.
## How It Works
1. The extension runs a content script on all Twitter/X pages.
2. It identifies username elements in tweets and user profiles.
3. For each username, it queries Twitter's GraphQL API endpoint (`AboutAccountQuery`) to get the account's location.
4. The location is displayed next to the username, right in the UI.
## Technical Details
- **Page Script Injection:** The extension injects a script into the page context to make API requests. This allows it to:
- Access the same cookies and authentication as the logged-in user
- Make same-origin requests to Twitter's API without CORS issues
- Work seamlessly with Twitter's authentication system
- **Content Script Communication:** The content script listens for location fetch requests. When a username is detected, it sends a custom event to the page script, which makes the API request and returns the location data.
- **Caching:** Location data is cached in your browser's IndexedDB and expires automatically after 30 days to minimize API calls and improve performance.
## API Endpoint
The extension uses Twitter's GraphQL API endpoint:
```
https://x.com/i/api/graphql/XRqGa7EeokUU5kppkh13EA/AboutAccountQuery
```
With variables:
```json
{
"screenName": "username"
}
```
The response contains the `account_based_in` field in:
```
data.user_result_by_screen_name.result.about_profile.account_based_in
```
## Limitations
- Requires the user to be logged into Twitter/X.
- Only works for accounts that have location information available.
- Location names are shown as returned by the API.
- Rate limiting: 50 requests per 15 minutes (extension will show a warning if limit is reached).
## Privacy
- The extension only queries public account information.
- No data is stored or transmitted to third-party servers.
- All API requests are made directly to Twitter/X servers.
- Location data is cached locally using Firefox IndexedDB and expires after 30 days.
## Troubleshooting
If locations are not appearing:
1. Make sure you're logged into Twitter/X.
2. Check the browser console for any error messages.
3. Verify that the account has location information available.
4. Try refreshing the page.
5. If you hit the rate limit, wait 15 minutes before trying again.
For more help, see [Support](#support).
---
## Contributing
Contributions are welcome! To contribute:
1. Fork the repository and create your branch from `main`.
2. Make your changes with clear commit messages.
3. Open a pull request describing your changes.
For bug reports or feature requests, please use [GitHub Issues](https://github.com/mamantoha/twitter-account-location/issues).
---
## Support
For questions, suggestions, or help, please open an issue on the [GitHub Issues page](https://github.com/mamantoha/twitter-account-location/issues).
---
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.