{"id":35476100,"url":"https://github.com/xlemmingx/ha-torn","last_synced_at":"2026-02-13T15:15:46.054Z","repository":{"id":331451307,"uuid":"1126688643","full_name":"xlemmingx/ha-torn","owner":"xlemmingx","description":"Torn City API-Integration plugin for HomeAssistant","archived":false,"fork":false,"pushed_at":"2026-01-12T11:52:23.000Z","size":65,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T21:33:24.994Z","etag":null,"topics":["hacs","home-assistant","home-assistant-integration","homeassistant-custom-component","torn","torn-city"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xlemmingx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-02T11:56:45.000Z","updated_at":"2026-01-12T11:39:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xlemmingx/ha-torn","commit_stats":null,"previous_names":["xlemmingx/ha-torn"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/xlemmingx/ha-torn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xlemmingx%2Fha-torn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xlemmingx%2Fha-torn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xlemmingx%2Fha-torn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xlemmingx%2Fha-torn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xlemmingx","download_url":"https://codeload.github.com/xlemmingx/ha-torn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xlemmingx%2Fha-torn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28573281,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T15:45:05.669Z","status":"ssl_error","status_checked_at":"2026-01-19T15:44:23.317Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs","home-assistant","home-assistant-integration","homeassistant-custom-component","torn","torn-city"],"created_at":"2026-01-03T12:13:53.984Z","updated_at":"2026-02-13T15:15:46.040Z","avatar_url":"https://github.com/xlemmingx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Torn City Integration for Home Assistant\n\nA comprehensive Home Assistant integration for [Torn City](https://www.torn.com), providing real-time access to your player stats, finances, stocks, travel status, cooldowns, and more.\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)\n[![GitHub Release](https://img.shields.io/github/release/xlemmingx/ha-torn.svg)](https://github.com/xlemmingx/ha-torn/releases)\n[![Downloads](https://img.shields.io/endpoint?url=https://vaskivskyi.github.io/ha-custom-analytics/badges/torn/total.json)](https://github.com/xlemmingx/ha-torn)\n[![License](https://img.shields.io/github/license/xlemmingx/ha-torn.svg)](LICENSE)\n\n## Installation\n\n### HACS (Recommended)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=xlemmingx\u0026repository=ha-torn\u0026category=integration)\n\n1. Open HACS → Integrations → Custom repositories\n2. Add `https://github.com/xlemmingx/ha-torn` as \"Integration\"\n3. Search for \"Torn City\" and install\n4. Restart Home Assistant\n\n### Manual Installation\n\n1. Download from [releases page](https://github.com/xlemmingx/ha-torn/releases)\n2. Copy to `config/custom_components/torn/`\n3. Restart Home Assistant\n\n## Configuration\n\n1. Settings → Devices \u0026 Services → Add Integration\n2. Search \"Torn City\"\n3. Enter your [Torn City API key](https://www.torn.com/preferences.php#tab=api) (**Full Access** recommended)\n4. Optional: Enable \"Throttle API Usage\" to reduce API calls if needed\n5. Submit\n\n### Customizing API Endpoints\n\nAfter setup, you can configure which features to enable:\n\n1. Settings → Devices \u0026 Services → Torn City → Configure\n2. Enable/disable individual features (Money, Travel, Cooldowns, Stats, Skills, Company, Stocks, Refills, Log)\n3. Disabled features reduce API usage and remove associated sensors\n\nProfile \u0026 Bars are always enabled (core functionality).\n\n## Features\n\n### Player \u0026 Stats\n- Name, level, status, battle stats (strength, defense, speed, dexterity)\n\n### Bars \u0026 Cooldowns\n- Energy, Nerve, Happy, Life, Chain with timers\n- Chain timeout timer\n- Drug, Medical, Booster cooldowns\n\n### Finances\n- Wallet, Vault, Banks, Company \u0026 Faction funds\n- City Bank investments with profit tracking\n- Daily networth\n\n### Stocks (All 35 Torn stocks)\n- Current prices, market cap, owned shares\n- Stock benefit blocks tracking\n- Ready-to-claim benefits\n\n### Travel \u0026 Activity\n- Destination, method, arrival/departure times\n- Recent activity log\n\n### Other\n- Skills (dynamic sensors)\n- Company stats\n\nAll sensors prefixed with `sensor.torn_` and `binary_sensor.torn_`.\n\n## API Rate Limiting\n\nThe integration uses intelligent caching to minimize API calls:\n- High frequency (5s cache): profile, bars, money, travel, log\n- Medium frequency (60s cache): cooldowns, stats, company, stocks\n- Low frequency (600s cache): skills, refills\n\n**Default usage: ~64 API calls/minute** (64% of the 100/minute limit)\n\n### Reducing API Usage\n\n1. **Disable unused endpoints**: Configure the integration to disable features you don't use (each disabled feature saves 1-2 API calls)\n2. **Enable \"Throttle API Usage\"**: Reduces update frequency by 10x if you're sharing an API key or approaching limits\n\n## Privacy \u0026 Security\n\nThis integration stores your Torn City API key **locally** in your Home Assistant configuration only.\n\n- No data is sent to external servers\n- No data sharing with third parties\n- API key is used only for fetching your personal Torn City data\n- All data remains on your Home Assistant instance\n\n## Support\n\n- [GitHub Issues](https://github.com/xlemmingx/ha-torn/issues)\n- [Torn API Documentation](https://www.torn.com/swagger.php)\n\n## License\n\nMIT License - see LICENSE file for details.\n\nThis integration is not affiliated with Torn City Ltd.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxlemmingx%2Fha-torn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxlemmingx%2Fha-torn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxlemmingx%2Fha-torn/lists"}