honzajavorek / film2trello

Turns film links to Trello cards 🍿

film2trello

Personal Telegram bot which turns CSFD.cz and KVIFF.TV film links to Trello cards 🍿 Allows me and my wife to use Trello as our "To Watch" list for films. Assumed Trello board structure:

• First column is an inbox, a "To Watch" list.
• Any number of "Seen" columns follows, e.g. "Seen in 2024", "Seen in 2023"…
• Last column is "Archive". If a card is in the inbox for several years, it gets moved out of the way to this archive.

Setup

• Install by Poetry
• Set TELEGRAM_TOKEN environment variable to the token BotFather gives you
• Set TRELLO_KEY environment variable to something you get at Trello Power-Ups Admin
• Set TRELLO_TOKEN environment variable to something you get at Trello Power-Ups Admin, alternatively make a GET request to https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=film2trello&key=<TRELLO_KEY>, where TRELLO_KEY is the key above.
• Verify which Trello board you want to use, because the default value for the board ID is set to ours. Override it with --board. Get the ID of your board from its URL, e.g. if the URL of the board is https://trello.com/b/mF7A3n3J/filmy-test, then mF7A3n3J is the ID.
• Verify which Telegram users you want to allow and how they map to your Trello users, because the default values are set to us. Override it with --user, e.g. --user=119318534:honzajavorek. You can use the option multiple times to allow more users. I don't remember how I've got the Telegram account IDs, ask the internet.
• Run film2trello bot
• Stop by Ctrl+C

Development

• Use Poetry to manage dependencies.
• Run pytest to test.
• Run ruff check to lint.
• Run ruff format to format code.
• To temporarily turn off production, run flyctl machine stop. To bring it back, run flyctl machine start.

Deployment

The app runs on Fly.io. Install their flyctl. Then you can do things like flyctl launch --name=film2trello or flyctl deploy. Use the following to prepare the environment:

$ flyctl secrets set TRELLO_KEY=... TRELLO_TOKEN=... TELEGRAM_TOKEN=...

The app also uses GitHub Actions. It needs the TRELLO_KEY, and TRELLO_TOKEN secrets set on the secrets setting page. The rest is in the .github directory.

Automatic Deployment

Set GitHub Actions secret FLY_API_TOKEN to a value you get by running flyctl auth token.

License

MIT

film2trello's Issues

Support dafilms.cz

https://dafilms.cz/film

Make the form created by bookmarklet invisible

Sometimes the action takes time and the form is visible, which is ugly. It fits to current state of UI, but...

Label films we have locally?

Add film to a #1 position

The scrolling is endless!

Handle situation with a wrong username

Very low execution timeout limit

10s for hobby plans, sometimes won't accommodate creation of the Trello card :/

• https://vercel.com/docs/serverless-functions/introduction#execution-timeout
• https://vercel.com/docs/platform/limits#serverless-function-execution-timeout

Better support for TV Shows

Record individual series, not a whole show. E.g. https://www.csfd.cz/film/702753-f1-touha-po-vitezstvi/1180287-serie-5/prehled/

Attach CSFD url

https://developers.trello.com/reference/#cardsidattachments-1

Cleaned cookies result in None as a pre-filled username

TV Shows point to the parent URL and not to SE01, SE02, etc.

2024-01-21 23:45:25,123 - film2trello.core - INFO - CSFD.cz URL: https://www.csfd.cz/film/697624-love-death-robots/prehled/
2024-01-21 23:45:26,130 - film2trello.core - INFO - Different target URL, scraping: https://www.csfd.cz/film/697624-love-death-robots/prehled/
2024-01-21 23:45:27,350 - film2trello.core - INFO - Different parent URL, scraping: https://www.csfd.cz/film/697624-love-death-robots/prehled/
...
2024-01-21 23:45:29,324 - film2trello.core - INFO - CSFD.cz URL: https://www.csfd.cz/film/1184280-medved/prehled/
2024-01-21 23:45:29,783 - film2trello.core - INFO - Different target URL, scraping: https://www.csfd.cz/film/1184280-medved/prehled/
2024-01-21 23:45:30,402 - film2trello.core - INFO - Different parent URL, scraping: https://www.csfd.cz/film/1184280-medved/prehled/

Turn into Telegram bot?

Adding films could work as a Telegram bot instead of bookmarklet in browser

Refactor & test the code

Get info about the remembered username, display avatar, allow for change

If a username is remembered, it's displayed as avatar and "is this not you" link which opens the input

Add proxy for too large images

Pillow apparently has some issues with posters

e.g. https://www.csfd.cz/film/1184280-medved/prehled/

New label denoting TV shows

Support IMDb

• scrape https://www.imdb.com/title/tt1433540/
• get "A Town Called Panic (2009)"
• search for it https://www.csfd.cz/hledat/?q=A+Town+Called+Panic+%282009%29
• get first link

Move all TV shows to the main inbox

Make sure the code correctly deals with stuff like "svazek"

https://www.csfd.cz/film/697624-love-death-robots/galerie/

Add some security, lol

Currently anyone guessing my Trello account will be able to add films to my board

Screenshot or sth consistently fails

For https://www.csfd.cz/film/737780-karel-ja-a-ty/prehled/

URL validation in the bookmarklet

The bookmarklet should validate the URL and reject to do anything in case the URL doesn't look like a valid one. That would be nice to have to avoid the often happening situation when I mistakenly click the bookmarklet button on a different site.

Domain name lost by moving DNS to WEDOS, Vercel complains

TV shows should have S01 etc. in their title

Add information about length of films

The title should contain S01 etc.

Archive old stuff

If something is there for several years, what's the point?

Sometimes submitting a film crashes with HTTP 400

Looks like it happens when f2t needs to create a new label? O_o

400 Client Error: Bad Request for url:
https://trello.com/1/cards/5da2df514260c55dfaab182a/labels?token=<TRELLO_TOKEN>&key=<TRELLO_KEY>&name=1.5h&color=yellow