{"id":21261530,"url":"https://github.com/chenasraf/nextcloud-autocurrency","last_synced_at":"2026-04-12T23:30:29.122Z","repository":{"id":76046556,"uuid":"596282410","full_name":"chenasraf/nextcloud-autocurrency","owner":"chenasraf","description":"Auto fetches currency information for your Cospend projects on Nextcloud","archived":false,"fork":false,"pushed_at":"2026-03-02T20:36:18.000Z","size":1789,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-02T23:45:59.739Z","etag":null,"topics":["cospend","nextcloud","nextcloud-app"],"latest_commit_sha":null,"homepage":"https://apps.nextcloud.com/apps/autocurrency","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chenasraf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"chenasraf","patreon":null,"open_collective":null,"ko_fi":"casraf","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=TSH3C3ABGQM22\u0026currency_code=ILS\u0026source=url"]}},"created_at":"2023-02-01T21:07:47.000Z","updated_at":"2026-03-02T20:36:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"78bb8dc6-334a-4328-8b37-f900c1fde767","html_url":"https://github.com/chenasraf/nextcloud-autocurrency","commit_stats":null,"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"purl":"pkg:github/chenasraf/nextcloud-autocurrency","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fnextcloud-autocurrency","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fnextcloud-autocurrency/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fnextcloud-autocurrency/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fnextcloud-autocurrency/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chenasraf","download_url":"https://codeload.github.com/chenasraf/nextcloud-autocurrency/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fnextcloud-autocurrency/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30156258,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T22:39:40.138Z","status":"ssl_error","status_checked_at":"2026-03-05T22:39:24.771Z","response_time":93,"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":["cospend","nextcloud","nextcloud-app"],"created_at":"2024-11-21T04:43:40.311Z","updated_at":"2026-04-12T23:30:29.110Z","avatar_url":"https://github.com/chenasraf.png","language":"JavaScript","funding_links":["https://github.com/sponsors/chenasraf","https://ko-fi.com/casraf","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=TSH3C3ABGQM22\u0026currency_code=ILS\u0026source=url","https://ko-fi.com/casraf'"],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: Chen Asraf \u003ccontact@casraf.dev\u003e\nSPDX-License-Identifier: CC0-1.0\n--\u003e\n\n# Auto Currency for Cospend\n\nThis NextCloud app automatically fetches currency information for your Cospend projects, and fills\nthem up using the main currency as base. No more manually updating exchange rates!\n\nYou can also view the history of currency rates fetched in the past, and see how they changed over\ntime.\n\n![Nextcloud Auto Currency](/promo.png)\n\nIt will automatically run once a day by default and use your currency names to fetch the correct\nrate.\n\nInterval for fetch may be adjusted in the admin settings \"Auto Currency\" section.\n\n\u003e **Note**: This is a companion app to [Cospend](https://apps.nextcloud.com/apps/cospend).\n\u003e\n\u003e Without Cospend, this app will not work.\n\n## Preparing currency data\n\nTo make sure your currencies are found for the rates to be updated, please ensure your currencies\nare named appropriately.\n\nFor both main and additional currencies, Currency names must contain **at least one of**:\n\n- Currency symbol (`$`, `€`, `£`, etc.)\n- Currency code (USD, EUR, GBP, etc.) - case insensitive\n\nUsing one of these will be enough to fetch the correct rate.\n\nExample working names:\n\n- ✅ `$`\n- ✅ `USD`\n- ✅ `$ USD`\n- ❌ `US Dollar`\n- ❌ `United States Dollar`\n\nFor a full list of available currencies, see [symbols.json](lib/Service/symbols.json), or refer to\nthe table in the app's settings screen.\n\n## Installation\n\nDownload the app from [Nextcloud's App Store](https://apps.nextcloud.com/apps/autocurrency) through\nyour Nextcloud instance.\n\nIf you prefer to download manually, you can download the latest version from GitHub and install\ndirectly:\n\n1. Place this app in **nextcloud/apps/** or **nextcloud/custom_apps/**\n\n2. Here is a quick installation script you can use as base. Modify the first variable lines to match\n   your setup:\n\n   ```bash\n   pushd \"/path/to/root/of/nextcloud/custom_apps\"\n\n   APPVER=$(curl -s https://api.github.com/repos/chenasraf/nextcloud-autocurrency/releases/latest | grep tag_name | grep -Eo 'v[^\"]+') \u0026\u0026 \\\n   curl -L https://github.com/chenasraf/nextcloud-autocurrency/releases/download/${APPVER}/autocurrency-${APPVER}.tar.gz -o autocurrency.tar.gz \u0026\u0026 \\\n   tar xfv autocurrency.tar.gz \u0026\u0026 \\\n   rm -rf autocurrency.tar.gz\n   ```\n\n3. Then enable the app as you normally would from Nextcloud's Apps page.\n\n## Contributing\n\nI am developing this package on my free time, so any support, whether code, issues, or just stars is\nvery helpful to sustaining its life. If you are feeling incredibly generous and would like to donate\njust a small amount to help sustain this project, I would be very very thankful!\n\n\u003ca href='https://ko-fi.com/casraf' target='_blank'\u003e\n  \u003cimg height='36' style='border:0px;height:36px;'\n    src='https://cdn.ko-fi.com/cdn/kofi1.png?v=3'\n    alt='Buy Me a Coffee at ko-fi.com' /\u003e\n\u003c/a\u003e\n\nI welcome any issues or pull requests on GitHub. If you find a bug, or would like a new feature,\ndon't hesitate to open an appropriate issue and I will do my best to reply promptly.\n\n## Development\n\n### Automation\n\nMost development processes are automated:\n\n- **GitHub Actions** run tests, builds, and validations on each push or pull request.\n- **Pre-commit formatting** is handled by [Lefthook](https://github.com/evilmartians/lefthook),\n  which automatically formats and lints code before committing.\n\n\u003e 🛠️ Lefthook is installed automatically via the `prepare` script after `pnpm install`.\n\n---\n\n### Manual Commands\n\nWhile automation handles most workflows, the following commands are available for local development\nand debugging:\n\n#### Build the App\n\n```bash\nmake\n```\n\nInstalls dependencies and compiles frontend/backend assets.\n\n#### Run Tests\n\n```bash\nmake test\n```\n\nRuns unit and integration tests (if available).\n\n#### Format \u0026 Lint\n\n```bash\nmake format   # Auto-fix code style\nmake lint     # Check code quality\n```\n\n#### Generate OpenAPI Docs\n\n```bash\nmake openapi\n```\n\nOutput is saved to `build/openapi/openapi.json`.\n\n#### Packaging for Release\n\n```bash\nmake appstore    # Production build for Nextcloud app store\nmake source      # Full source package\nmake distclean   # Clean build artifacts and dependencies\n```\n\n#### Sign Releases\n\nAfter uploading the archive to GitHub:\n\n```bash\nmake sign\n```\n\nDownloads the `.tar.gz` release, verifies it, and prints a SHA-512 signature using your key at\n`~/.nextcloud/certificates/autocurrency.key`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchenasraf%2Fnextcloud-autocurrency","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchenasraf%2Fnextcloud-autocurrency","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchenasraf%2Fnextcloud-autocurrency/lists"}