Skip to content
A library for parsing/building frame ranges and sequences. A port of the python fileseq library, for Go (https://github.com/justinfx/fileseq)
C++ Go Other
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows
cmd
cpp cpp: fix broken handling of frame range negative step parsing for PCR… Oct 20, 2019
exp/cpp
ranges
testdata
.gitignore
.goreleaser.yml
.travis.yml
CHANGES
LICENSE
README.md
bench_test.go
fileseq.go
fileseq_test.go
frameset.go
go.mod
go.sum cmd:update seqls to use a faster parallel filesystem walk library Nov 23, 2019
pad.go
sequence.go

README.md

Fileseq

Go project version GoDoc Travis Build Status Go Report

A Go language library for parsing file sequence strings commonly used in VFX and animation applications.

Ported from the original fileseq Python library: https://github.com/justinfx/fileseq

For C++, see C++ Support

Frame Range Shorthand

Support for:

  • Standard: 1-10
  • Comma Delimted: 1-10,10-20
  • Chunked: 1-100x5
  • Filled: 1-100y5
  • Staggered: 1-100:3 (1-100x3, 1-100x2, 1-100)
  • Negative frame numbers: -10-100
  • Padding: #=4 padded, @=single pad

Sequence Formats

Sequences of files are expected to follow a pattern similar to:

  • /path/to/some/file_foo.0100.exr
  • /path/to/some/file_foo.1-100#.jpg
  • /path/to/some/file_foo.1-100@@@.tif

Install

go get github.com/justinfx/gofileseq

Also included is a seqls tool, which uses gofileseq to produce an executable, used for listing sequences on the filesystem:

And seqinfo tool, which can print plain-text or json parsed information about one or more sequence strings.

Download the latest binary release

Or install from source:

go get github.com/justinfx/gofileseq/cmd/seqls
seql some/images
# some/images/file_foo.1-100@@@.tif

C++ Support

A C++ pure port of gofileseq is also available in the cpp dir

You can’t perform that action at this time.