# Image Sequence Player library for Processing

**URL:** https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174
**Category:** Gallery
**Created:** [September 24, 2019, 3:07pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174 "2019-09-24T15:07:43Z")
**Posts on this page:** 12
**Page:** 1

<div class="post-metadata">

### Author: ![George](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/george/32/5858_2.png) [@George](https://discourse.processing.org/u/George)
#### Post date: [September 24, 2019, 3:07pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/1 "2019-09-24T15:07:43Z")

</div>

Hi,

I’ve recently releases a simple library for Processing: [https://github.com/orgicus/image-sequence-player](https://github.com/orgicus/image-sequence-player)

It’s very **very** similar to gifAnimation, instead it loads an image sequence and plays it back.

This is handy if you want more colours and better quality transparency than the gif format can offer and need frame based control (as opposed to video keyframes).

It was useful for many LED panel projects at [Hirsch & Mann](http://www.hirschandmann.com/work)  
and hope you find it useful too.

I’m open to feedback/suggestions.

If you have any tips on submitting the library to the Contribution Manager, more than happy to hear from you.

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [September 27, 2019, 10:59pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/2 "2019-09-27T22:59:33Z")

</div>

Thanks so much for developing and sharing this!

> [@George](#):
>
> any tips on submitting the library to the Contribution Manager

Are you asking for advice on the submission protocol – or is it for feedback on the library before it is submitted?

Your library.properties looks like it is already set up correctly. The process for submission of a library is detailed here:

- [Library Basics · processing/processing Wiki · GitHub](https://github.com/processing/processing/wiki/Library-Basics#advertising-your-library)

…and happy to help if you have any further questions!

---

<div class="post-metadata">

### Author: ![George](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/george/32/5858_2.png) [@George](https://discourse.processing.org/u/George)
#### Post date: [September 30, 2019, 4:42pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/3 "2019-09-30T16:42:08Z")

</div>

@jeremydouglass

Feedback for the library before it is submitted would be amazing !  
More than happy to update and improve it.

Going through the wiki as far as I can tell I simply need to email the Processing Librarian.

Thank you,  
George

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [September 30, 2019, 9:26pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/4 "2019-09-30T21:26:59Z")

</div>

Great!

One recommendation: a best practice for GitHub distribution is to create a release tag eg “latest” or “PDE” and attach a zip with no version name, eg mylibrary.zip and the accompanying mylibrary.txt – then submit that as your url. This gives you a stable download url, and the released version is automatically updated in Processing whenever you tag a releases with “latest” (you can tag it with a version at the same time).

---

<div class="post-metadata">

### Author: ![George](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/george/32/5858_2.png) [@George](https://discourse.processing.org/u/George)
#### Post date: [October 7, 2019, 10:31pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/5 "2019-10-07T22:31:09Z")

</div>

@jeremydouglass I had a stab at following your instructions.

Hope I got them right:

1. I manually created a release, uploading the generated .zip and .txt files ([https://github.com/orgicus/image-sequence-player/releases/tag/v1.0.0-alpha](https://github.com/orgicus/image-sequence-player/releases/tag/v1.0.0-alpha))
2. I also added a docs folder where I added generated files again (library zip, site and javadocs): [https://orgicus.github.io/image-sequence-player/#download](https://orgicus.github.io/image-sequence-player/#download)

I’m not 100% if the second step is legit or if there’s a better way to set that up.

What do you think ? (What other improvements could I make / is it good to be submitted ?)

Thank you so much,  
George

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [October 8, 2019, 5:24pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/6 "2019-10-08T17:24:20Z")

</div>

Some quick feedback:

1. it looks like you accidentally attached the text file and the zip _twice_ to your release. You can delete the duplicates.

[https://github.com/orgicus/image-sequence-player/releases/download/v1.0.0-alpha/ImageSequencePlayer.txt](https://github.com/orgicus/image-sequence-player/releases/download/v1.0.0-alpha/ImageSequencePlayer.txt)

1. The docs folder doesn’t hurt anything, but it is unnecessary.

The key concept is that your file, once attached to a release, gets this URL

[https://github.com/orgicus/image-sequence-player/releases/download/v1.0.0-alpha/ImageSequencePlayer.txt](https://github.com/orgicus/image-sequence-player/releases/download/v1.0.0-alpha/ImageSequencePlayer.txt)

…but it also gets a URL for any tag it has.

1. Now tag it with “latest” (or whatever stable tag you prefer)

Now, your attachment also has this URL:

[https://github.com/orgicus/image-sequence-player/releases/download/latest/ImageSequencePlayer.txt](https://github.com/orgicus/image-sequence-player/releases/download/latest/ImageSequencePlayer.txt)

This is the URL that you will submit when you submit your library.

Once your library is submitted, it will always check /latest/ for the txt and zip.

Then, when you make a new release, upload new attachments ImageSequencePlayer.txt and ImageSequencePlayer.zip. When you are ready to release it to Contributions Manager, tag your new release with “latest”. Now the contributions manager will find your new info and zip at the /latest/ URL.

Does that make sense?

---

<div class="post-metadata">

### Author: ![George](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/george/32/5858_2.png) [@George](https://discourse.processing.org/u/George)
#### Post date: [October 8, 2019, 8:34pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/7 "2019-10-08T20:34:41Z")

</div>

@jeremydouglass Thank you so much for the feedback, much appreciated 😃

1. I’ve removed the the duplicates (hopefully the right ones :))
2. I’ve moved the docs to the `gh-pages` branch to tidy up
3. I’ve just tagged a realease with “latest”  
(For new releases I can delete the current “latest” and make a new “latest” tag, correct ?)

Did I get it ? 😃

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [October 9, 2019, 2:27am UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/8 "2019-10-09T02:27:37Z")

</div>

> [@George](#):
>
> For new releases I can delete the current “latest” and make a new “latest” tag, correct ?

That’s right! Note you can give a release multiple tags. So you can tag releases like this

v0.1  
v0.2  
v0.2.1  
v0.3 , latest  
v0.4b , dev

…and whichever you choose tag “latest” (or “release”, or “PDE”, or whatever tag url you submit) will be what PDE shows and downloads. People can get your 0.4b release from your repo, but PDE won’t until you move the “latest” tag. In an emergency you could also roll the tag back to a previous release.

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [October 11, 2019, 7:38pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/9 "2019-10-11T19:38:47Z")

</div>

One tiny reminder – don’t forget to also tag your ‘latest’ with its version number. Right now it only says “latest” – but it is also something after 1.0.0, like 1.0.1, or 1.1.

---

<div class="post-metadata">

### Author: ![George](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/george/32/5858_2.png) [@George](https://discourse.processing.org/u/George)
#### Post date: [October 15, 2019, 7:36pm UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/10 "2019-10-15T19:36:29Z")

</div>

That sounds nice! I would like to do that.

I tried it, but I think I’m doing it wrong ?

 ![25](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/8/89d9dddaae97c9b2cad0443d99909af7e40d1052.jpeg)

 ![37](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/3/3c6418d0c7cb701078fd799419ed320a1f31375c.jpeg)

Can you please point me in the right direction ?

Many thanks again for your support ❤

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [October 16, 2019, 1:46am UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/11 "2019-10-16T01:46:40Z")

</div>

I can’t tell what is happening there. Did you create a tag called “@”? That is an illegal tag name.

> <https://stackoverflow.com/questions/26382234/what-names-are-valid-git-tags>

---

<div class="post-metadata">

### Author: ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)
#### Post date: [October 16, 2019, 1:53am UTC](https://discourse.processing.org/t/image-sequence-player-library-for-processing/14174/12 "2019-10-16T01:53:04Z")

</div>

Or maybe ? you created a tag called “1.0.1, latest” but you want to create two separate tags like this: “1.0.1” “latest”. Are you creating tags through the GitHub online, or through the GitHub desktop client, sourcetree, or command line git etc.?
