isamert / orgmdb.el

An Emacs/org-mode watchlist manager and OMDb API client

orgmdb.el

Tools for managing your watchlist in org-mode and some functions for interacting with OMDb API.

Installation

orgmdb is available through MELPA. If you have it set up already, just do M-x package-install orgmdb and you are good to go. Otherwise please see MELPA getting started page to learn how you can install packages through MELPA or see the following installation options.

Another way to install orgmdb.el would be using either straight or quelpa package managers:

;; Using straight:
(use-package orgmdb
  :straight (:host github :repo "isamert/orgmdb.el"))

;; Using quelpa:
(use-package orgmdb
  :quelpa (orgmdb :fetcher github :repo "isamert/orgmdb.el"))

Yet another option is just downloading orgmdb.el file and putting into your load-path, afterwards you can simply do the following in your init.el:

(require 'orgmdb)

Demo

Displaying detailed movie information

Filling movie metadata

Opening a local video

Configuration

You need get yourself an API key to be able to use this package, see OMDb website. After getting yourself an API key, you can start using by doing:

(setq orgmdb-omdb-apikey "YOUR-API-KEY")

Interactive usage

orgmdb.el offers several actions that you can call upon a movie/show/episode objects. These actions can be accessed by calling orgmdb-act function. A movie/show object is simply an org header with a tag, like the following:

* Crouching Tiger, Hidden Dragon (2000) :movie:
* Succession (2018-) :series:

You can put your cursor on one of the headers and call orgmdb-act. From the menu, you can select Fill movie properties to pull movie metadata under the :PROPERTIES: drawer of the selected header. From now on, you can use other actions defined under the orgmdb-act menu.

An episode object is a special one, because it can be either a header containing an episode marker object (meaning something like S02E05) with an :episode: tag:

* Succession (2018-) :series:
** S01E08 - Prague :episode:

or it can be simply an episode marker object:

* Succession (2018-) :series:
- ...
- I watched S01E08 yesterday and it was cool.
-           ^^^^^^ here is our episode marker object

In both cases, if your cursor is on the episode object, orgmdb-act will understand the context and show the actions accordingly.

Here are the actions and their simple explanations:

Fill properties

Fill the metadata of the current object. See `orgmdb-fill-property-list` variable to control which properties gets filled in.

Show detailed info

Open a nicely formatted org buffer and display a detailed info of the current object with a small poster of it.

Select an episode...

Select an episode of the currently focused show and act on it.

Open local video

Find the local video file containing the current movie/show/episode. It searches video files under orgmdb-video-dir and looks for files with orgmdb-video-file-extensions extensions. orgmdb-player-function is used for opening the video file.

Defining new actions

You can define new actions for movie/show/episode objects using orgmdb-defaction function. See the following example:

(orgmdb-defaction
 :name 'show-info
 ;; ^ Define a unique name for this action
 :definition "Show title of the currently selected object"
 ;; ^ User-facing definition of the action
 :on '(movie show episode)
 ;; ^ On what objects this action should appear?
 :act (cl-function
       (lambda (type &key title imdb-id episode &allow-other-keys)
         (message "The title is %s, imdb-id is %s" title imdb-id))))

Library usage

(let ((movie (orgmdb :title "in the mood for love")))
  (format "Movie name: %s, Year: %s, Plot: %s"
          (orgmdb-title movie)
          (orgmdb-year movie)
          (orgmdb-plot movie)))

(orgmdb :title "thinking of ending things" :year 2020)

;; This returns something like this:
((Title . "I'm Thinking of Ending Things")
 (Year . "2020")
 (Rated . "R")
 (Released . "04 Sep 2020")
 (Runtime . "134 min")
 (Genre . "Drama, Thriller")
 (Director . "Charlie Kaufman")
 (Writer . "Charlie Kaufman (written for the screen by), Iain Reid (based on the book by)")
 (Actors . "Jesse Plemons, Jessie Buckley, Toni Collette, David Thewlis") (Plot . "Full of misgivings, a young woman travels with her new boyfriend to his parents' secluded farm. Upon arriving, she comes to question everything she thought she knew about him, and herself.")
 (Language . "English, Spanish")
 (Country . "USA") ...)

orgmdb.el's Issues

Export entry as bibtex

Great!

I was thinking when I saw this mode that it might be useful to have a yank-as-bibtex-entry creating a properly formatted snippet of a bibtex entry (which can be then pasted in an ebib buffer, or bib file etc.)

Fill movie properties from IMDb id?

I really like this package! Is there a way to fill movie properties using the unique IMDb id? I'm unable to get orgmdb identify the right entry in some cases, typically involving series episodes (example).

Error, can't do anything...

Contacting host: www.omdbapi.com:80
Decrypting /home/dave/.emacs.d/.local/etc/authinfo.gpg...done
error in process filter: epa-file-insert-file-contents: Opening input file: Decryption failed,
error in process filter: Opening input file: Decryption failed,

orgmdb--open-video assumes no spaces, no \, no ', ...

I noticed that this was packaged in Guix, and took a look at the source code.

More specifically, I noticed:

        (format "fd --absolute-path --type=file %s --glob '*%s*%s' %s"
                (concat "--extension " (s-join " --extension " orgmdb-video-file-extensions))
                it
                (if (not (s-blank? episode))
                    (concat (s-downcase episode) "*")
                  "")
                video-dir)))

The apparent (unverified!) issue with this code, is that it treats everything as a single string, without any quoting -- consider, e.g., the situation where 'video-dir' contains spaces (e.g. if it's ~/My Videos) or && (~/Videos && Other stuff).

One method to solve this, is to quote the arguments. However, I noticed Emacs has another method for starting processes, wherein every argument is passed as separate strings, which avoids quoting issues entirely, in https://www.gnu.org/software/emacs/manual/html_node/elisp/Asynchronous-Processes.html and https://www.gnu.org/software/emacs/manual/html_node/elisp/Synchronous-Processes.html (with :command and 'args' respectively).

Tweak fill movie detail settings

Hello, it's not clear from your README how to adjust what property gets filled in with "Fill properties". I'd like to also download the cover and attach it to the header so it can be displayed when you expand the entry.

Is this possible?

I'm not very familiar with LISP so any direction would be helpful. Thanks...

I wanted to submit this as a feature request.

[FR] Add `writers` property

E.g., for https://www.imdb.com/title/tt0805647/ :

[FR] Insert IMDB, Metacritic, RottenTomato scores

Do not insert `N/A`, use `user-error` when data is not found

When I invoke it on ** [[https://www.wikiwand.com/en/Dumb_and_Dumber][Dumb and Dumber | Wikiwand]], I get:

:PROPERTIES:
:GENRE:    N/A
:RUNTIME:  N/A
:DIRECTOR: N/A
:IMDB-ID:  N/A
:END:

It would be better if it just errored.

wrong request url?

I got an error message in emacs:
Wrong authorization used for http://www.omdbapi.com/?apikey=xxxxxxx&t=I%27m%20Thinking%20of%20Ending%20Things&y=nil&type=movie
So I tried http://www.omdbapi.com/?apikey=xxxxxxx&t=I%27m%20Thinking%20of%20Ending%20Things&y=nil&type=movie in the browser and it failed to fetch, but http://www.omdbapi.com/?t=I%27m%20Thinking%20of%20Ending%20Things&y=nil&type=movie&apikey=xxxxxxx works for me.
Is it possible to fix this problem?

orgmdb-act doesn't respect orgmdb-movie-tag new value

Hi, when i change orgmdb-movie-tag variable the orgmdb-act doesn't respect the new value and just use "movie" instead, is this correct? could you support custom names for the tags? i want to have in the tag in other language

Thanks for the great package!