For the complete documentation index, see llms.txt. This page is also available as Markdown.
Page cover

Manual

Download the quick start guide here.

FAQ

Connectivity

How do I connect my turntable?

Connect the RCA output of your turntable to the 3.5 jack input of the Devious Pocket.

We recommend connecting the turntable directly to the devious pocket using a high quality RCA to 3.5 cable with a maximum length of 1 meter, to minimize signal loss. If your turntable lacks a detachable RCA cable (common on older Technics models), use a coupler to adapt RCA to 3.5mm.

How do I ground my turntable?

We recommend that you ground your turntable directly to your mixer, using a turntable ground wire. If the turntable isn't grounded, the time-code vinyl may not be read correctly, and you might hear a humming sound in pass-through mode.

What is the right input volume?

There are many different types of phono cartridges available, with varying output voltage based on their intended purpose. Our benchmark cartridge is the Ortofon Concore MKII Mix, which has an output voltage of 6mV.

We recommend setting the input volume to a level that has the level meter sit at approx 1/3th of the full range, with time code enabled. This allows for more than enough room for vinyl playback in pass-through mode and enough amplitude for the system to decode the time-code vinyl accurately.

What phono cartridge do you recommend?

Most cartridges are compatible, but for best results, we recommend using a cartridge with a minimum output of 6mV, such as the Ortofon Concorde MKII Mix. We tested and developed the system using a variety of Ortofon MKII cartridges and all worked perfectly. Just make sure you adjust the input volume as described in the section above.

Track plays backwards?

Flip the RCA connectors - some 3.5mm jacks have their polarity reversed.

My 3.5mm jack doesn't fit?

We’ve heard from some users that the case can be a bit too tight for larger 3.5mm jack plugs. Unfortunately, not every cable will fit. If you encounter this, we recommend using this cable, which we’ve tested and confirmed to work.

File Management

How do I manage my music library?

No proprietary software required - just organize your files in folders and copy them to your USB. Devious Pocket reads ID3 tags and offers to sort by title, artist, album, BPM, key, or genre. It also offers search within folders.

Since version 1.2 the Devious Pocket also supports playlists exported from Rekordbox.

What file formats are supported?

mp3, flac, wav, aif, caf, and ogg

What partition formats are supported?

FAT32, exFAT, EXT4 and NTFS

What USB stick do you recommend?

Not every flash drive is the same, after extensive testing we recommend the Samsung USB 3.1 FIT Flash Drive. It is small, fast, runs relatively cool and is of good build quality. Use the USB2 ports if your device or stick is getting hot. USB3 ports require more continuous power, which can place additional stress on both the stick and the hardware.

Can I use an SSD?

We currently support all USB attached SCSI drives, including solid state drives, hard drives and sticks.

Do you support Rekordbox playlists?

Since version 1.2 we do, check the playlist section for more details.

Operation

What time code formats are supported?

Serato 2, Serato CD, Traktor 1, Mixvibes V2, Mixvibes 7 and Pioneer time code formats

What control vinyl do you recommend?

We recommend using Serato 2, which is considered the best in terms of quality and loudness and was used as the main format during development of the unit.

Why does my Traktor control vinyl not work as expected?

Newer Traktor time-code vinyl (version 2+) uses a proprietary format that we cannot decode properly. We do support the original Traktor control vinyl (version 1) but haven't been able to validate it because it's not in production any more. For best results we recommend using Serato 2, as described in the previous section.

How do I synchronize 2 units?

Set the pitch of both units to the same tempo and lock it by pressing the lock icon in the play view. When loading a new track the system will internally pitch the new track to match the locked BPM at a pitch of 0. Put the pitch slider at 0 and both tracks should now be in sync until you unlock the tempo again.

Vinyl control stopped working?

This can happen by accident, and is triggered by pressing the round icon in the top left corner of the screen in the play view. This switches the control mode from vinyl to internal, which allows you to remove the needle from the record and continue playback at the last know pitch. Because this disables external control it can lead to confusion.

To enable record control mode again, simply press the play / pause icon for 2 seconds and everything should be back to normal.

switch to control mode
I can't find my track?

Currently search is limited to the directory you're in. We're exploring ways to enable global or nested file searches, which will be included in a future update.

Does it support Phase DJ?

Absolutely, you can use Phase DJ to adjust the pitch and our track view to move the playhead. Cueing and looping are fully supported as well.

Can I update the firmware?

Yes, the firmware can be updated over USB by plugging in a drive with the firmware update. The system will run the update on startup when found.

Hardware

Is it safe to power the unit on / off using a switch?

Yes it is. We do not write any data to the boot or firmware partitions, these are considered read-only. Non-critical data, such as logs and settings, are stored in a dedicated non-critical partition. That said, it is still recommended to use sleep mode rather than powering the unit on and off with the switch.

What power adapter should I use?

The unit requires a dedicated 5V, 3A (15W minimum) USB C adapter, compatible with the Raspberry Pi 4. Do not use your phone or laptop charger, these are not compatible with the Devious and will damage the hardware when used.

Why does the screen feel hot?

The screen can feel hot to touch when the unit is running in a not well ventilated environment of more than 30°C. This is caused by the heat emitted by the controller chip on the screen, in combination with the increased heat of the CPU.

There is no harm in the screen running hot. As long as the unit does not throttle extensively everything should continue to work as expected. You can see if the unit has throttled by tapping the </> icon at the bottom of the settings page, it should say 'never' if it has not throttled, otherwise a hex code indicating when it throttled.

We include a significant performance buffer to guarantee that the unit will keep operating as intended, even when throttling occurs.

USB3 or USB2?

Both work equally well, with USB3 (blue port) having a slight advantage in speed, which doesn't have a large impact on loading times, because most of that time is spent on re-sampling & analysis.

USB2 has one big advantage over USB3; it draws less power and therefore makes the unit run less hot. In our testing we found that certain USB3 sticks draw a lot of power and run very hot, raising the overall temperature of the unit. This is caused by the stick continuously drawing power from the computer, in combination with the controller chip on the stick itself. It does this to meet the high transfer speeds required by the USB3 specification.

We therefore recommend to use USB2 instead of USB3 when ambient temperatures are high or your stick gets hot.

Are the blue ports USB3?

Yes, the blue ports are USB3, the other are USB2.

What is a good operating temperature?

The measured temperature = CPU temperature, not the system temperature and is allowed to go up to 85°C before the system starts throttling. Under regular circumstances the temperature hoovers around 60°C to 65°C. In very hot, humid environments the temperature can go up to 75°C.

The unit is passively cooled, to minimize noise and potential points of failure, but that does come at the cost of increased CPU temperatures. If you feel your unit runs too hot you can increase airflow by adding a USB powered fan, and use the USB2 instead of USB3 ports. Also avoid exposing it to direct sunlight when it's hot.

As long as the unit does not throttle extensively everything should continue to work as expected. You can see if the unit has throttled by tapping the </> icon at the bottom of the settings page, it should say 'never' if it has not throttled, otherwise a hex code indicating when it throttled.

We include a significant performance buffer to guarantee that the unit will keep operating as intended, even when throttling occurs.

What's the audio latency?

The Devious Pocket significantly outperforms traditional USB solutions. This advantage comes from its direct CPU connection, eliminating the need to package and unpack audio data through USB frames. Internal processing latency is 0.666 ms, which doesn't account for latency introduced by transmission, which varies but 'averages' around 1-2 ms, as explained here.

But there's more to latency than just numbers: the Devious Pocket avoids running a full desktop environment, resulting in a snappier, more responsive experience. Its hardware-accelerated GUI is faster than most alternatives and we use real-time audio scheduling for improved timing and stability. The software is written in C++, using our own in-house developed real-time control and visualization platform NAP Framework, which has been battle tested in production for years and is used by us and our partners to power performance critical, large scale interactive installations and embedded solutions world-wide.

Playlists

Support for Rekordbox playlists is available since firmware version 1.2.0. Ensure your Devious Pocket is running that version or later.

Note that this is an 'experimental' feature. If you encounter any issues, we recommend reverting back to an older version. Tested with Rekordbox version 7.2.18.0311.

1

Export

Inside Rekordbox create and select a playlist; In the top menu click on:

  • Playlist > Export Playlist > USB

For the Devious to read the playlist we also export it as a .txt file:

  • Playlist > Export a playlist to a file > Export a playlist to a file (.txt)

Place the exported .txt file somewhere on the same USB drive and eject it.

2

Select & Play

Plug your USB drive into the Devious Pocket and click on the newly created .txt file. The system will automatically match the tracks in there to individual files in the Contents directory. Tracks in a playlist can be sorted like regular tracks, but they use data from Rekordbox (like BPM and Key) instead of the file's metadata.

How does it work?

When you open a playlist the Devious will try to match each track on screen to a file on your drive. When the file is found, the title turns from grey to white. If the file can't be found the track is darkened out. This allows you to inspect your export before heading off the club.

Note that finding a match can take some time, depending on the speed of your drive, selected USB port and size of your content. However, you can still select and load a track while the matching is in progress.

Update

Only update the device if you need new features that improve your workflow. Don't update the device if you're happy using it - changes might change or interrupt your current flow.

1

Check current version

Open the Settings page and tap </> to check the current version on the first line.

2

Download update

Go to the download page and download the latest version. If your current version is higher or equal to the online version don't update, unless you want to roll back to a previous one.

3

Write update to USB

4

Flash update

Turn the Devious Pocket off, plug the USB stick with the update into it and turn it on.

The system will detect the update and run it on initialization, just before launching into the application. Wait for the screen to turn from orange (in progress) to blue. If the screen turns blue the update succeeded, if the screen turns red the update failed. Wait a few seconds then power off the unit.

Wait for it to complete! Never interrupt the update process, as it might corrupt your device.

5

Validate

Remove the USB stick with the update and turn the device back on to confirm everything works as expected. If the updated failed the system should revert back to it's current version. If the unit fails to boot after the update send a mail to support.

Recovery

In the unfortunate event something goes wrong during update or internal storage fails, you can flash a new image to a micro SD card to restore the firmware. This isn't as hard as it sounds, so don't despair! It's a good thing you can do this yourself, because it prolongs the lifespan of your device and you don't have to return it to us for repair.

This doesn't fix hardware issues, such as a broken screen. In that case you have to contact support and / or follow the hardware repair guide (coming soon).

1

Download and unzip the .img

Download the latest image (coming soon) and unzip it using your favorite tool.

2

Write the .img to micro SD card

Insert a (new) micro SD card of at least 16 GB card into your reader and install the official Raspberry Pi Imager.

After installation; select Raspberry Pi 4, click on Use Custom and open the unzipped .img file. Next select your SD card and proceed with writing the downloaded .img to the device. Wait for validation to succeed and remove the SD card from the reader.

Win32 Disk Imager also works. Other imaging tools might work but have not been tested and are not supported. All existing data on that card will be lost after writing the devious pocket .img to that card.

3

Remove bottom plate

4

Remove top plate

5

Replace micro SD card

Replace the existing micro SD card with the new one. Destroy the old one (seriously!)

6

Assemble the unit

7

Request a license

Power it on and wait for the device to boot. Instead of the regular user interface you should see a code. Take a clear picture of this code and send it to support@nap.works. We use this code - which is unique to your machine - to generate a new license.

Why? Because the Devious Pocket is protected against unauthorized copy & theft. This license allows us to distribute the .img without the (immediate) risk of people stealing our firmware and re-distributing and / or selling it without our consent.

8

Install license

After receiving the license files from support:

Turn the Devious Pocket off, plug the USB stick with the license into it and turn it on.

Before launching the app, the system looks for a license in the devious-pocket folder and installs it if found. Upon success operation should be back to normal, if not send a mail to support.

Support

If you have any issues or questions, please send a mail to support@nap.works