iblancasa / google-slides-asciinema

A Chrome extension to embed asciinema animations in your Google Slides

Google Slides asciinema

Have you ever work with asciienma? It's an amazing tool for creating tutorials or avoiding the "demo effect" when you are doing presentations.

asciinema allows to embed the animations in different places like websites. With Javascript, you can integrate those animations easily in tools like revealjs but there is not a way to integrate those animations with Google Slides...

... and this Chrome extension was born!

How to install it

You have to follow these steps:

1. Clone this repository
2. Type chrome://extensions in your Chrome browser
3. Enable the "Developer mode" by clicking the toggle switch
4. Click "LOAD UNPACKED" and search the folder where this repository was cloned. Then, open the chrome_extension folder.
5. The extension is ready to use!

How to use the extension

After enabling it, all you have to do is creating draw circle, rectangle or add an image to your slides. Then, add a link to the desired asciinema animation website. For instance: https://asciinema.org/a/14

Remember that, if you add .png to that URL, you will get a preview for the asciinema animation. For the previous example, it would be https://asciinema.org/a/14.png. So, you can include that image in your Google slides and add the link to the asciinema animation: if the Chrome extension is installed, you will see the animation totally embedded in your slides. If not, you'll have a preview linked with the real animation (and that works too for PDF 😉).

License

This project is licensed under the Apache 2.0 license.

Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

google-slides-asciinema's Issues

Google Slides removed .punch-viewer-svgpage

I just installed the extension and it is not working.
Looking into Google Slides HTML, the scanListener is not finding any term that matches .punch-viewer-svgpage a.

Probably a change on Google Slides broke the extension.

Port to Firefox

Since this extension doesn't use anything from the Chrome API, it should be compatible with Firefox.

https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension

Doesn't work with current asciinema

Great idea, would love to see it work but the plugin tries to load https://asciinema.org/a/item_id/embed which 404's.

Port to Greasemonkey

It would be amazing to port it to Greasemonkey.

It should be possible since the extension is not using anything from the Chrome API.

Create documentation about how to use it step by step

Visual documentation like a video or something would be amazing. At least, some written documentation.

Adding additional flags doesn't work

I'm trying to add "?size=big" to the link, but it is not working. Looks like other parameters don't work either.