Skip to content

Releases: SierraSoftworks/ynab-automation

v2.4

12 Jul 14:53
6c1b2f5
Compare
Choose a tag to compare

What's Changed

Full Changelog: v2.3...v2.4

Version 2.3

15 Jun 20:32
c20a3d1
Compare
Choose a tag to compare

This release adds support for calculating Capital Gains Tax adjustments on your stock holdings, improving the accuracy of your net worth calculations if things are going well in your investment portfolio.

Setup

  1. Create a new YNAB Personal API Token by following their guide.

  2. Configure your repository's secrets to include the following:

    • YNAB_API_KEY: Your YNAB Personal API Token
    • YNAB_BUDGET_ID: The ID of your YNAB budget, this is the first GUID in the URL when you are viewing your budget in the YNAB web app.
  3. Create your own repository, and place a .github/workflows/ynab.yaml file with the following contents.

    name: YNAB
    
    on:
      schedule:
         # Run the automation every 12 hours
        - cron: '0 */12 * * *'
    
    jobs:
      automate-ynab:
        runs-on: ubuntu-latest
        steps:
          - uses: SierraSoftworks/ynab-automation@v2.3
            with:
              budget-id: ${{ secrets.YNAB_BUDGET_ID }}
              api-key: ${{ secrets.YNAB_API_KEY }}
              cache: true

Automatic Updates

If you want to automatically update to the latest version of the YNAB automation, you can add a .github/dependabot.yml file
to your repository with the following contents. It will automatically create pull requests to update your repository when new
versions are released.

version: 2
updates:
  - directory: /
    package-ecosystem: github-actions
    schedule:
      interval: weekly

Version 2.2

03 Dec 17:20
88574d8
Compare
Choose a tag to compare

This release fixes some issues with initial runs when cache: true is configured.

Setup

  1. Create a new YNAB Personal API Token by following their guide.

  2. Configure your repository's secrets to include the following:

    • YNAB_API_KEY: Your YNAB Personal API Token
    • YNAB_BUDGET_ID: The ID of your YNAB budget, this is the first GUID in the URL when you are viewing your budget in the YNAB web app.
  3. Create your own repository, and place a .github/workflows/ynab.yaml file with the following contents.

    name: YNAB
    
    on:
      schedule:
         # Run the automation every 12 hours
        - cron: '0 */12 * * *'
    
    jobs:
      automate-ynab:
        runs-on: ubuntu-latest
        steps:
          - uses: SierraSoftworks/ynab-automation@v2.2
            with:
              budget-id: ${{ secrets.YNAB_BUDGET_ID }}
              api-key: ${{ secrets.YNAB_API_KEY }}
              cache: true

Automatic Updates

If you want to automatically update to the latest version of the YNAB automation, you can add a .github/dependabot.yml file
to your repository with the following contents. It will automatically create pull requests to update your repository when new
versions are released.

version: 2
updates:
  - directory: /
    package-ecosystem: github-actions
    schedule:
      interval: weekly

Version 2.1

26 Nov 00:10
dd1372c
Compare
Choose a tag to compare

This release adds support for automatically cleaning the datasource cache and better handling errors from the Yahoo Finance API.

Setup

  1. Create a new YNAB Personal API Token by following their guide.

  2. Configure your repository's secrets to include the following:

    • YNAB_API_KEY: Your YNAB Personal API Token
    • YNAB_BUDGET_ID: The ID of your YNAB budget, this is the first GUID in the URL when you are viewing your budget in the YNAB web app.
  3. Create your own repository, and place a .github/workflows/ynab.yaml file with the following contents.

    name: YNAB
    
    on:
      schedule:
         # Run the automation every 12 hours
        - cron: '0 */12 * * *'
    
    jobs:
      automate-ynab:
        runs-on: ubuntu-latest
        steps:
          - uses: SierraSoftworks/ynab-automation@v2.1
            with:
              budget-id: ${{ secrets.YNAB_BUDGET_ID }}
              api-key: ${{ secrets.YNAB_API_KEY }}
              cache: true

Automatic Updates

If you want to automatically update to the latest version of the YNAB automation, you can add a .github/dependabot.yml file
to your repository with the following contents. It will automatically create pull requests to update your repository when new
versions are released.

version: 2
updates:
  - directory: /
    package-ecosystem: github-actions
    schedule:
      interval: weekly

Version 2.0

25 Nov 23:32
c24cdda
Compare
Choose a tag to compare

This release is the first to be offered as a pure GitHub Action which can be easily consumed from anyone's repository, greatly simplifying setup and maintenance, while making staying up to date easier.

Setup

  1. Create a new YNAB Personal API Token by following their guide.

  2. Configure your repository's secrets to include the following:

    • YNAB_API_KEY: Your YNAB Personal API Token
    • YNAB_BUDGET_ID: The ID of your YNAB budget, this is the first GUID in the URL when you are viewing your budget in the YNAB web app.
  3. Create your own repository, and place a .github/workflows/ynab.yaml file with the following contents.

    name: YNAB
    
    on:
      schedule:
         # Run the automation every 12 hours
        - cron: '0 */12 * * *'
    
    jobs:
      automate-ynab:
        runs-on: ubuntu-latest
        steps:
          - uses: sierrasoftworks/ynab-automation@v2
            with:
              budget-id: ${{ secrets.YNAB_BUDGET_ID }}
              api-key: ${{ secrets.YNAB_API_KEY }}
              cache: true

Automatic Updates

If you want to automatically update to the latest version of the YNAB automation, you can add a .github/dependabot.yml file
to your repository with the following contents. It will automatically create pull requests to update your repository when new
versions are released.

version: 2
updates:
  - directory: /
    package-ecosystem: github-actions
    schedule:
      interval: weekly