aboutsummaryrefslogtreecommitdiff
path: root/doc/troubleshooting.html
blob: 184f702d5b3a51075b25bf3511eaddc3d711c3ad (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<!DOCTYPE html>
<html>
<head>
<title>QMidiPlayer Help</title>
<link rel=stylesheet href='styles.css' type='text/css'>
</head>
<body>
	<div id="panel">
		<ul>
			<li><a href="index.html">Overview</a></li>
			<li><a href="mainwindow.html">Main Window</a></li>
			<li><a href="channeldialog.html">Channels Dialog</a></li>
			<li><a href="channeleditor.html">Channel Editor</a></li>
			<li><a href="plistdialog.html">Playlist</a></li>
			<li><a href="efxdialog.html">Effects</a></li>
			<li><a href="optionsdialog.html">Settings</a></li>
			<li><a href="visualization.html">Visualization</a></li>
			<li><a href="cmdargs.html">Commandline arguments</a></li>
			<li><a class="active" href="troubleshooting.html">Troubleshooting</a></li>
			<li><a href="miscellaneous.html">Miscellaneous</a></li>
			<li><a href="version.html">Version Info.</a></li>
			<li><a href="license.html">License</a></li>
		</ul>
	</div>
	<div id="content">
		If troubleshooting cannot solve your problem, please don't hesitate to report an issue.
		<h3>1. I can't hear anything!</h3>
		<p>
			<ol>
			<li>Check current audio driver in the option dialog. Do not use an audio driver
			that is not installed on your system.</li>
			<li>If no soundfont is loaded, the internal synthesizer won't make any sound...</li>
			<li>Check audio driver/buffer settings in the synth section.</li>
			<li>Check if your midi file is valid/having correct bank selecting method<s>/having zero volume</s>.</li>
			</ol>
		</p>
		<h3>2. The playback is intermittent.</h3>
		<p>
			Try increasing audio buffer size and/or audio buffer count in synth options.
		</p>
		<h3>3. MIDI timing is messed up.</h3>
		<p>
			This is a known issue under Windows. Try decreasing audio buffer size and
			increasing audio buffer count.
		</p>
		<h3>4. Some files cannot be played.</h3>
		<h3>5. Some soundfonts cannot be loaded.</h3>
		<p>
			Files names with characters unsupported by the system locale
			won't load correctly in Windows. This is a known issue.
		</p>
		<h3>6. Sound is distorted.</h3>
		<p>
			Try reducing the master volume.
		</p>
		<h3>7. Bank selecting is incorrect for the internal synth.</h3>
		<p>
			Change default midi mapping if necessary.
		</p>
		<h3>8. Bank selecting is incorrect for external devices.</h3>
		<p>
			Bank selecting to external devices is sent in raw format. The midi
			file may be incompatible with your device.
		</p>
		<h3>9. 3D visualization is upsidedown/rotated/black/blinking.</h3>
		<p>
			For those who see a rotated and blinking display, try setting
			Visualization-Video/Multisampling to 1 or above. If that doesn't
			solve your problem or you see nothing at all, please send me more
			details about your problem (graphics card, drivers etc.).
		</p>
		<p>
			Devices/drivers reported to have this issue:
			<ul>
				<li>Intel HD 5500 found in i5-5200U / official Windows driver</li>
				<li>Unknown low-end AMD card / official Windows driver</li>
				<li>Raspberry Pi 2 VC4 / Full KMS OpenGL (GLX)</li>
			</ul>
		</p>
	</div>
</body>
</html>