Lelonio/Square

Download · Features · First launch · FAQ · Telegram community · Building

Player	Lyrics	Effects
Artist	Album	Glass settings

• Spotify or YouTube Music, chosen at first launch and switchable in the settings. Home, search, the library and the player work the same on both.
• Spotify: your own account, with its playlists, library and Connect devices. Needs Premium.
• YouTube Music: the whole catalogue and the music videos, with no account needed. Sign in with Google to bring in your playlists, albums and followed artists.

• The cover or the song's looping canvas video behind the controls.
• Music videos: switch from the song to its video in place, without losing the queue or the position, and keep watching in picture-in-picture.
• Radio from any song, and autoplay of similar songs when the queue ends.
• Crossfade between songs, with an option to skip trailing silence.
• Sleep timer: after 5 to 60 minutes or at the end of the song, fading out before it stops.

• Speed and pitch, each on its own, plus reverb.
• Presets, so "slowed + reverb" is one tap on any song.
• Karaoke: turn the voice down.
• Streaming quality that follows the connection, or a fixed one.

• Synced lyrics, word by word where they exist and line by line otherwise.
• Translation into your language, under the original lines.

• Playlists, albums, artists and liked songs. Create, rename and delete playlists, add and remove songs, pin favourites, follow artists.
• A home page of shelves made for you, a New tab with releases and charts, and a Radio tab of stations, moods and genres.
• Search, with your recent searches kept (swipe one away to remove it).
• The music already on your phone, in a Local files shelf.

• Download playlists, albums and songs, from either source. A song kept by two playlists is downloaded once.
• Downloads over Wi-Fi only, and automatic downloads of your liked songs.
• Offline mode: play only what is on the phone.

• A Connect device: send playback to Square from any other device, and control your other devices from it.
• What your friends are listening to.
• Similar playlists at the end of each playlist.
• Song credits: performers, writers and producers.
• What you play is saved to your listening history, as it would be anywhere else you listen.
• Spotify links can open straight in Square.

• Browse playlists and recently played, search by voice, like a song or start a radio from the car.

• Every control, the tab bar, the player, the sheets and the menus are made of one refracting glass. Blur, refraction and tint are adjustable, with a lighter mode for slower phones.
• Eight languages: English, Italian, Spanish, French, German, Portuguese, Hindi and Turkish, chosen independently of the phone's own.

Or

Download the APK from the latest release and install it. Square needs Android 8.0 or later.

Square updates itself: it checks for new releases and installs them from the settings. It is not on the Play Store and cannot be; see the disclaimer.

adb shell cmd package compile -m speed-profile -f dev.lelonio.square

Square first asks where the music should come from. You can change it later in the settings.

• YouTube Music plays straight away. Signing in with Google, from the settings, is optional.
• Spotify needs a Premium account and a few minutes of guided setup: you sign in, then register a free app of your own in Spotify's developer dashboard and paste its client ID. Search and a few other features go through Spotify's Web API, which limits requests per app, so with your own app the limit is yours alone. The setup walks you through every step.

Square does not appear in Android Auto. Android Auto only lists apps installed from the Play Store. Turn on "Unknown sources" in Android Auto's developer settings and Square shows up.

Can I use a free Spotify account? No. A free account can sign in, but Spotify only streams to a client like this one with Premium. YouTube Music works with no account at all.

YouTube Music search works, but songs do not play. YouTube changes how its streams are served every so often. Update to the latest release, which is usually where the fix is.

Square is not affiliated with, endorsed by or connected to Spotify or Google. Both sources are used on terms they do not offer: Square re-implements Spotify's protocol, which Spotify's Terms of Service forbid, and reads YouTube Music through the private endpoints its own web client uses. It cannot be published on the Play Store, and you use it at your own risk. There is no warranty of any kind; see the licence.

• Telegram community: join Square | Community for questions, feedback, bug reports and feature requests.
• Release announcements: Square | Official automatically shares new APKs and release notes from GitHub.
• Questions (how something works, how to set it up): Discussions, Q&A
• Ideas and requests: Discussions, Ideas
• Something broken: open an issue. If the app closed or froze, attach a report from Settings → About → Save a report.

The same two links are in the app, under Settings → About.

Square is free and has no ads. If it is useful to you, you can support its development on Ko-fi.

Requirements, build steps, signing, the architecture and notes on the code are in docs/DEVELOPMENT.md.

GPL-3.0-or-later. See LICENSE.

The lyrics view, LyricsView.kt, is ported from Spicy Lyrics and stays under AGPL-3.0, combined with the rest as section 13 of both licences allows.