Implementation of Snapchat's stories timer.

Last update: Sep 5, 2022

Overview

SnapTimer

SnapTimer is a custom UIView that behaves exactly the same as the one on Snapchat's stories.

Swift 3.0 Support on master branch! 👌👌 
Swift 2.3 Support on Swift2.3.

Features

Two different timers, 'outer' and 'inner'.
Independent animations for each of the timers.
Customizable colors.
Completion handlers.
Fully Swift.

What does it look like?

A picture is worth a thousand words

Installation

You can just clone the repo and copy the SnapTimer folder to your project or you can use one of the following options:

Setting up with CocoaPods

pod 'SnapTimer'

Then:

import SnapTimer

And you are all set!

Setting up with Carthage

TODO

How do I add it?

Add a UIView to your Storyboard.
Select the view, go to the Identity Inspector and set the class to SnapTimerView
Create an @IBOutlet in your view controller and that's it.

SnapTimerView implements @IBDesignable so the view should automatically render in your Interface Builder. Also it implements @IBInspectable for the view properties:
That's it!

Setting inner and outer values

innerValue and outerValue ranges go from 0 to 100.

To set values without animations you just have to:

self.snapTimerView.outerValue = 25 self.snapTimerView.innerValue = 50

   ![ej1](images/ej1.gif)

* To animate values:

    ```swift
self.snapTimerView.animateOuterValue(50)
self.snapTimerView.animateInnerValue(25)

To animate values setting the time and a completion handler:

self.snapTimerView.animateOuterToValue(50, duration: 30) {
    puts("Done!")
}

self.snapTimerView.animateInnerToValue(100, duration: 30) {
    puts("Done!")
}

Pausing and resuming animations:

if your app goes to background or the Notifications/Control center are opened you may want to pause the animations, to do that SnapTimer has two handy methods:

self.snapTimerView.resumeAnimation()
self.snapTimerView.pauseAnimation()

Check the sample project!

Cool ways to improve it?

Hey, If you have cool ideas to add to this please feel free to send a PR! Also if you are using this in your app and what to let me know I'll be happy to add a section here with the apps currently using this!

You might also like...

Schedule timing task in Swift using a fluent API. (A friendly alternative to Timer)

Schedule(简体中文) Schedule is a timing tasks scheduler written in Swift. It allows you run timing tasks with elegant and intuitive syntax. Features Elega

1.8k Dec 21, 2022

This project is a minimalistic Pomodoro timer for OS X written in Swift

Minimalistic Pomodoro for OSX This project is a minimalistic Pomodoro timer for OS X written in Swift started by @bengsfort, and substantially enhance

2 Nov 17, 2021

The most perfect Swift Timer you'll ever need.

Timerable ⏰ The most perfect Swift Timer you'll ever need. A protocol-oriented Timer Factory with all the features you'll ever need. I wrote it in bot

24 Dec 22, 2022

Well-tested GCD Timer in Swift

GCDTimer Well tested Grand Central Dispatch (GCD) Timer in Swift. Checkout the test file. Usage Long running timer import GCDTimer class Demo { in

183 Sep 9, 2022

A timer that lets you know when your ramen is ready to eat!

Dependencies Ramen Timer requires the following: Gifu SwiftySound On Xcode simply go to File Add Packages and input the names on the searchbar then

1 Nov 3, 2021

This is an open source app made to help home brewers brew their coffee by calculating the grams of water needed, and run a timer all in the same screen.

Ratios This is an open source app made to help home brewers brew their coffee by calculating the grams of water needed, and run a timer all in the sam

64 Jan 1, 2023

Swift image slideshow with circular scrolling, timer and full screen viewer

🖼 ImageSlideshow Customizable Swift image slideshow with circular scrolling, timer and full screen viewer 📱 Example To run the example project, clon

1.7k Dec 21, 2022

Egg timer app written in Swift

Egg Timer Our Goal This module will be a mix of tutorials and challenges. Most importantly, we want you to get comfortable with looking up how to do s

0 Dec 2, 2021

A simple Timer app for Mac

2.3k Jan 8, 2023

A handy class for iOS to use UILabel as a countdown timer or stopwatch just like in Apple Clock App.

MZTimerLabel Purpose MZTimerLabel is a UILabel subclass, which is a handy way to use UILabel as a countdown timer or stopwatch just like that in Apple

1.6k Dec 14, 2022

Egg Timer app helps you to cook your egg in the way you want

Egg Timer Egg Timer app helps you to cook your egg in the way you want. You need to decide on how do you want to eat your egg than just click the egg

2 Nov 29, 2022

THORChain vault churn countdown timer for macOS tray

ChurnCountdown Useful macOS tray app to show THORChain churn countdown. On start

0 Jan 5, 2022

A basic countdown app that allows the user to create, edit, and delete events. Each event contains a live countdown timer to a specified date and time.

Event Countdown App (iOS) Created by Lucas Ausberger About This Project Created: January 4, 2021 Last Updated: January 8, 2021 Current Verison: 1.1.1

1 Jan 8, 2022

Chess Timer - Time calculation application developed for chess game

Spin aims to provide a versatile Feedback Loop implementation working with the three main reactive frameworks available in the Swift community (RxSwift, ReactiveSwift and Combine)

With the introduction of Combine and SwiftUI, we will face some transition periods in our code base. Our applications will use both Combine and a thir

119 Dec 29, 2022

Comments

Can't Clear when Preparing For Reuse

I'm experiencing a bug where I have a couple timers in UITableViewCells and when scrolling sometimes the timers are set to the of another cell.

Ex: cell one: timer is at 30% ^ | | v cell two timer is supposed to be at 100% but displays at 30%

I've tried to put self.timer.animateOuterValue(0) in prepare for reuse but it didn't help

Thanks, Kevin

opened by ThoseGuysInTown 0
Animating timer with Duration does not work unless on main thread
@andresinaka When animating the timer with duration, it doesnt work unless run on the mainthread like so...perhaps this should be done in the timer object otherwise you will be left wondering why it doesnt work.

DispatchQueue.main.async { snapTimer.animateOuterToValue(100, duration: 100, completion: nil) }
opened by otymartin 0
Cant access Timer properties
@andresinaka The color properties are inaccessible apparently because of internal access controls.

let snapTimer = SnapTimerView(x: 0, y: 0, w: 24, h: 24) //How I initialize. Im not using storyboards
opened by otymartin 0

Implementation of Snapchat's stories timer.

Related tags

Overview

SnapTimer

Features

What does it look like?

Installation

Setting up with CocoaPods

Setting up with Carthage

How do I add it?

Setting inner and outer values

Pausing and resuming animations:

Check the sample project!

Cool ways to improve it?

You might also like...

Schedule timing task in Swift using a fluent API. (A friendly alternative to Timer)

This project is a minimalistic Pomodoro timer for OS X written in Swift

The most perfect Swift Timer you'll ever need.

Well-tested GCD Timer in Swift

A timer that lets you know when your ramen is ready to eat!

This is an open source app made to help home brewers brew their coffee by calculating the grams of water needed, and run a timer all in the same screen.

Swift image slideshow with circular scrolling, timer and full screen viewer

Egg timer app written in Swift

A simple Timer app for Mac

A handy class for iOS to use UILabel as a countdown timer or stopwatch just like in Apple Clock App.

Egg Timer app helps you to cook your egg in the way you want

THORChain vault churn countdown timer for macOS tray

A basic countdown app that allows the user to create, edit, and delete events. Each event contains a live countdown timer to a specified date and time.

Chess Timer - Time calculation application developed for chess game

Egg-Timer - Intermediate Swift Programming - Control Flow and Optionals

OpenFocusTimer - Pomodoro timer with categories, reflection, history & statistics

I have build a beautiful egg timer app to boil your eggs to perfection depending on how you prefer your eggs.

IdleTimerState - Control the idle timer for the SwiftUI app

Spin aims to provide a versatile Feedback Loop implementation working with the three main reactive frameworks available in the Swift community (RxSwift, ReactiveSwift and Combine)

Comments

Can't Clear when Preparing For Reuse

Animating timer with Duration does not work unless on main thread

Cant access Timer properties

Owner

Andres Canal

Plugin-spell-timer - Spell Timer Plugin for Outlander

IGStoryButtonKit provides an easy-to-use button with rich animation and multiple way inspired by instagram story/stories.

Snapchat / Instagram Stories like progress indicator

iOS App to show Top Stories from New York Times

Mybook swiftui - A Facebook UI Clone with some capabilities like like/unlike, comment, scroll, show stories etc

Simple command line interactive game to practice German (or English) with simple short stories.

Swift UI component - Stories instagram, slideshow, crypto wallet intro

GCDTimer - Well tested Grand Central Dispatch (GCD) Timer in Swift

Schedule timing task in Swift using a fluent API. (A friendly alternative to Timer)

This Control is a beautiful time-of-day picker heavily inspired by the iOS 10 "Bedtime" timer.