{"id":16228319,"url":"https://github.com/rdb/toggl2moneybird","last_synced_at":"2025-04-08T04:44:09.869Z","repository":{"id":205610354,"uuid":"714643272","full_name":"rdb/toggl2moneybird","owner":"rdb","description":"User-friendly command-line tool for synchronizing time entries from Toggl Track to Moneybird","archived":false,"fork":false,"pushed_at":"2024-03-22T00:30:26.000Z","size":82,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-23T03:00:12.198Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/rdb.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}},"created_at":"2023-11-05T13:34:59.000Z","updated_at":"2024-06-22T02:08:01.473Z","dependencies_parsed_at":"2024-06-22T02:07:59.620Z","dependency_job_id":"08f7d935-bac8-4e0e-9a45-f5480bc9d67e","html_url":"https://github.com/rdb/toggl2moneybird","commit_stats":null,"previous_names":["rdb/toggl2moneybird"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdb%2Ftoggl2moneybird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdb%2Ftoggl2moneybird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdb%2Ftoggl2moneybird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdb%2Ftoggl2moneybird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rdb","download_url":"https://codeload.github.com/rdb/toggl2moneybird/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247779796,"owners_count":20994572,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-10T12:55:03.665Z","updated_at":"2025-04-08T04:44:09.852Z","avatar_url":"https://github.com/rdb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# toggl2moneybird\n\nA user-friendly command-line tool for synchronizing time entries from\n[Toggl Track](https://toggl.com/track/) to [Moneybird](https://www.moneybird.com/).\n\n\u003cimg width=\"426\" alt=\"image\" src=\"https://github.com/rdb/toggl2moneybird/assets/194842/12f05a72-c536-4c75-9aff-658439cc267d\"\u003e\n\n## Installation\n\n    pip install toggl2moneybird\n\n## Running\n\nUsing the tool is self-explanatory.  On first-time use, a browser window will\nopen asking you to authorize the tool to access your Moneybird administration.\nIt will also ask you for your Toggl Track email address and password as needed,\nbut you may alternatively enter the API token listed at the bottom of your\n[profile page](https://track.toggl.com/profile).\n\nTo start the synchronization, type the following command.  The tool will always\nask you to confirm any changes, so you do not need to worry about the tool\nautomatically making changes to your administration.\n\n    toggl2moneybird sync\n\nOnly time entries corresponding to a project are synced.  By default, only\nbillable items are synced, but you can add the `--include-unbillable` flag to\ninclude unbillable items as well.\n\nYou can also automatically create a draft invoice for a particular contact and\nperiod using the following command:\n\n    toggl2moneybird invoice\n\nThe invoice will not be sent out automatically.  Instead, a browser window will\nopen with the draft invoice in Moneybird, allowing you to send it from there.\n\n## Billable flag\n\nBy default, only entries marked \"Billable\" in Toggl Track are synchronized.\nThere are two options to control this behaviour.  The `--include-unbillable`\nflag will cause all entries to be synchronized.  The \"Billable\" flag is only\nset in moneybird for entries that are marked \"Billable\" in Toggl Track.\n\nSince the \"Billable\" tag requires a paid Toggl Track subscription, there is an\noption to use a custom tag instead.  If you use `--unbillable-tag \"My Tag\"`,\nthen all Toggl Track entries will be considered billable, except those with\nthe tag \"My Tag\".  The option may be repeated for every tag that marks an\nunbillable entry.  If you would like to mark all imported entries billable in\nmoneybird, simply use this option with a silly tag name that doesn't exist.\n\nThe options are independent of each other and may be used together, in which\ncase *all* entries (except those specified by `--exclude-tag`) are imported,\nbut only the ones without the tags specified by `--unbillable-tag` are marked\nas \"Billable\" in the moneybird administration.\n\n## Advanced Filters\n\nYou can use `--project` with most commands to limit the effect of those\ncommands to only the specified projects.\n\nYou can use `--exclude-tag \"My Tag\"` to entirely ignore Toggl Track entries\nwith the specified tag.\n\n## Limitations\n\nThe Toggl Track API only allows accessing the last three months worth of data.\nIt is highly advised to run the sync at least once every month!\n\nCurrently, there is no mapping done between users - all time entries will be\nlogged under the same user (you will be asked which one if there are multiple).\n\nIt's not likely that you'll hit the rate limit of the Moneybird API using this\ntool, but if you do, the tool does not handle it gracefully and will quit with\nan exception.  Simply try again at a later time if you encounter this issue.\n\nIf you encounter any problems, please do not hesitate to report them in the\n[issue tracker](https://github.com/rdb/toggl2moneybird/issues).\nFeature requests are also welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frdb%2Ftoggl2moneybird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frdb%2Ftoggl2moneybird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frdb%2Ftoggl2moneybird/lists"}