ANSWER: Detailed Install Instructions

[brianhughesspe]

Not sure if all of this is absolutely necessary as I too am a novice coder, but this is what worked for me:

Setup

1. Install Docker Desktop on your system.
   Install GitHub Desktop on your system.
   Install Visual Studio Code on your system.
   Install Python on your system

2. From GitHub Desktop, go to File>Clone a repository>URL
   a. Add https://github.com/mtalcott/google-photos-deduper.git to the URL field, and choose the path you want it installed to (this should download the files you need to your machine, which we will need for step 4)

3. Create a Google Cloud project and OAuth credentials.

• Create a Google Cloud project (Guide)
  • Project name: Enter Photos Deduper
  • Select the project
• Go to APIs & Services > Enable APIs and Services
  • Search for Photos Library API
  • Enable
• Go to APIs & Services > OAuth consent screen
  • User Type: Choose External
  • Create
    • App name: Enter Photos Deduper
    • User support email: Choose your email
    • Developer contact information: Enter your email
    • Save and Continue
  • Add or remove scopes:
    • Manually add scopes:
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/userinfo.email
      • https://www.googleapis.com/auth/photoslibrary
    • Update
    • Save and Continue
  • Test users:
    • Add your email (and any others you want to use the tool with)
    • Save and Continue
• Go to APIs & Services > Credentials > Create Credentials > OAuth client ID
  • Application type: Choose Web application
  • Name: Enter Photos Deduper Web Client
  • Authorized JavaScript origins: Enter http://localhost/
  • Authorized redirect URIs: Enter http://localhost/auth/google/callback
  • Create
• Download the JSON file

4. Set up local environment variables.

• From GitHub Desktop, choose to Open the repository in your external editor
  

• From the items on the left, right click example.env, copy, and paste into the same location, rename that new file as simply “.env” without the quotes
  

• Open terminal/command prompt and Generate FLASK_SECRET_KEY with:

  • python3 -c 'import secrets; print(secrets.token_hex())'
  • Copy the output and add it to .env file from 4.b. Replacing the XYZ

• Add GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET from the client_id and client_secret values from the client secret file created above (JSON that you downloaded in step 3.e.

  • Add it to .env file from 4.b. Replacing the 123-ABC.apps.googleusercontent.com and ImAs3cREt!1, respectively

• File>save

Start

1. Run docker-compose up from the project directory.

• Easiest way for me to do this was to open the repository location in finder/file explorer and opening a new terminal/command prompt starting at that folder
  

• Then from terminal/cmd, Run docker-compose up

2. Load http://localhost/ and follow the instructions from there!
3. Install the Chrome Extension once you want to delete duplicates.

[aleon1220]

thanks for the detailed instructions. You should add a readme page Pull Request with instructions for mac.
I did run everything from Linux Ubuntu 22 with no issue as everything was rather native and straight forward...